User manual - デバイス制御ライブラリ リファレンスマニュアルver.1.01(2009年1月21日)

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