_read

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ファイルからデータを読み取ります。

int _read(
   int fd,
   void *buffer,
   unsigned int count 
);

パラメータ

fd
開いているファイルを参照するファイル記述子
buffer
データの格納場所
count
最大バイト数

戻り値

_read は、実際に読み取ったバイト数を返します。ファイル内に残っているバイト数が count より少ない場合またはファイルがテキストモードで開かれている場合は、このバイト数が count より少なくなることがあります。この場合、復帰と改行 (CR-LF: Carriage Return-Linefeed) の各組み合わせが 1 つの改行文字と置き換えられます。そのため、戻り値にはラインフィード文字 1 個分しかカウントされません。この置き換えはファイルポインタには影響しません。

関数がファイルの終端で読み取りを試行した場合は 0 を返します。fd が無効な場合、ファイルが読み取り用に開かれていない場合、またはファイルがロックされている場合は、「パラメータの検証」に説明されているように、無効なパラメータハンドラが呼び出されます。実行の継続が許可された場合、関数は –1 を返し、errno を EBADF に設定します。

buffer が NULL の場合、無効なパラメータハンドラが呼び出されます。実行の継続が許可された場合、関数は -1 を返し、errno は EINVAL に設定されます。

リターンコードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

解説

_read 関数は、fd に関連付けられているファイルから、count に指定した最大バイト数を読み取り、buffer に格納します。読み取り操作は、指定したファイルに関連付けられているファイルポインタの現在位置から開始します。読み取り操作が終わると、ファイルポインタは次に読み取る文字を指します。

ファイルをテキストモードで開いている場合、Ctrl + Z 文字が現れたところで読み取りが終了します。この文字は EOF (EOF: end-of-file) インジケータとして処理されます。EOF (EOF: end-of-file) インジケータをクリアするには、_lseek 関数を使用します。

必要条件

ルーチン	必須ヘッダー
_read	<io.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

ライブラリ

C ランタイムライブラリのすべてのバージョン。

使用例

// crt_read.c
/* This program opens a file named crt_read.txt
 * and tries to read 60,000 bytes from
 * that file using _read. It then displays the
 * actual number of bytes read.
 */

#include <fcntl.h>      /* Needed only for _O_RDWR definition */
#include <io.h>
#include <stdlib.h>
#include <stdio.h>
#include <share.h>

char buffer[60000];

int main( void )
{
   int fh;
   unsigned int nbytes = 60000, bytesread;

   /* Open file for input: */
   if( _sopen_s( &fh, "crt_read.txt", _O_RDONLY, _SH_DENYNO, 0 ) )
   {
      perror( "open failed on input file" );
      exit( 1 );
   }

   /* Read in input: */
   if( ( bytesread = _read( fh, buffer, nbytes ) ) <= 0 )
      perror( "Problem reading file" );
   else
      printf( "Read %u bytes from file\n", bytesread );

   _close( fh );
}