_read
ファイルからデータを読み取ります。
構文
int _read(
int const fd,
void * const buffer,
unsigned const buffer_size
);
パラメーター
fd
開いているファイルを参照するファイル記述子。
buffer
データの格納場所。
buffer_size
読み取る最大バイト数。
戻り値
_read では読み取りバイト数を返します。ファイル内にあるのが残り buffer_size バイト未満であるか、ファイルがテキスト モードで開かれている場合、これは buffer_size より小さいことがあります。 テキスト モードでは、復帰と改行のペア \r\n は、それぞれ 1 つの改行文字 \n に置き換えられます。 戻り値ではその単一の改行文字だけがカウントされます。 置換はファイル ポインターに影響しません。
この関数はファイルの終わりで読み取りをすると、0 を返します。 fdが有効でない場合、ファイルが読み取り用に開いていない場合、またはファイルがロックされている場合は、「パラメーター検証で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、この関数は -1 を返し、 errno を EBADFに設定します。
buffer が NULL である場合、または buffer_size>INT_MAX の場合、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、この関数は -1 を返し、errno は EINVAL に設定されます。
このリターン コードやその他のリターン コードの詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。
解説
_read 関数は buffer_size の最大バイトを、fd に関連付けられているファイルから buffer に読み込みます。 読み取り操作は、指定されたファイルに関連付けられたファイル ポインターの現在の位置で開始されます。 読み取り操作後、ファイル ポインターは、次の未読の文字を指します。
ファイルがテキスト モードで開かれた場合、ファイルの終わりを示すインジケーターとして扱われる CTRL + Z の文字が _read で検出された時点で、読み取りは終了します。 ファイルの終わりのインジケーターをクリアするには、_lseek を使用します。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
_read |
<io.h> |
互換性の詳細については、「 Compatibility」を参照してください。
ライブラリ
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, bytesread;
unsigned int nbytes = 60000;
/* 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 );
}
入力: crt_read.txt
Line one.
Line two.
出力
Read 19 bytes from file