User manual - デバイス制御ライブラリリファレンスマニュアル(2014年10月10日)

116
9.1.21 read
指定ファイル番号のファイルに対し、現在の読み出し位置から指定バイト数分のデータを、指定の領域へ
読み込みます。
int read(
int fileno ,
char * buf ,
unsigned int count
);
パラメータ
fileno
読み込み対象のファイル番号を指定します。
buf
読み込みデータを格納する領域のアドレスを指定します。
count
読み込データの要求バイト数を指定します。
戻り値
関数が成功すると実際に読み込んだデータのバイト数が返ります。
失敗すると、次のエラーが返ります。
E_LOWERR
：異常終了
解説
fileno パラメータには、open関数で取得したファイル番号を指定します。
指定バイト数以下でファイルが終了した場合は、そこで読み込みを終了します。
読出し位置は、読み込んだバイト数だけ先に進みます。正常終了した場合は、実際に読み込んだバ
イト数を返します。
データを読み込む前に、該当データブロックのチェックサムの確認を行ないます。チェックサムが正し
くない場合は、本関数は失敗します。
書き込み専用モードファイルに対し本関数を実行した場合、リターンパラメータ値は E_LOWERR を返
します。