f_read

ファイルからデータを読み出します。

FRESULT f_read (
  FIL* fp,     /* [IN] ファイル・オブジェクト構造体 */
  void* buff,  /* [OUT] 読み出したデータを格納するバッファ */
  UINT btr,    /* [IN] 読み出すバイト数 */
  UINT* br     /* [OUT] 読み出されたバイト数 */
);

引数

fp
ファイル・オブジェクト構造体へのポインタを指定します。
buff
読み出したデータを格納するバッファを指すポインタを指定します。
btr
読み出すバイト数(0〜UINT型の最大値)を指定します。
br
実際に読み出されたバイト数を格納する変数を指すポインタを指定します。戻り値は関数の成否にかかわらず常に有効です。

戻り値

FR_OK, FR_DISK_ERR, FR_INT_ERR, FR_NOT_READY, FR_DENIED, FR_INVALID_OBJECT, FR_TIMEOUT

解説

読み込み開始位置は、現在のリード/ライト・ポインタからになります。リード/ライト・ポインタは読み込まれたバイト数だけ進みます。関数が正常終了した後は、*brの値をチェックすべきです。*brがbtrよりも小さいときは、読み込み中にファイルの終端に達したことを示しています。

対応情報

全ての構成で使用可能です。

参照

f_open, fgets, f_write, f_close, FIL

戻る