X-Git-Url: http://cloudbase.mooo.com/gitweb/z180-stamp.git/blobdiff_plain/70702af1370e44e32fb2c3c507e4759a187b4fe5..289f6a146c0b2087607d8d8659531ea90142779a:/fatfs/doc/ja/gets.html diff --git a/fatfs/doc/ja/gets.html b/fatfs/doc/ja/gets.html deleted file mode 100644 index a979068..0000000 --- a/fatfs/doc/ja/gets.html +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - - - -FatFs - f_gets - - - - -
-

f_gets

-

ファイルから文字列を読み出します。

-
-TCHAR* f_gets (
-  TCHAR* buff, /* [OUT] バッファ */
-  int len,     /* [IN] バッファのサイズ */
-  FIL* fp      /* [IN] ファイル オブジェクト */
-);
-
-
- -
-

引数

-
-
buff
-
文字列を読み出すバッファを指すポインタを指定します。
-
len
-
バッファのサイズを要素数で指定します。
-
fp
-
ファイル オブジェクト構造体へのポインタを指定します。
-
-
- - -
-

戻り値

-

関数が成功するとbuffが返されます。

-
- - -
-

解説

-

読み出し動作は、最初の'\n'を読み込むか、ファイル終端に達するか、len - 1文字を読み出すまで続きます。読み込まれた文字列の終端には'\0'が付加されます。既にファイル終端で1文字も読み込まれなかったとき、または何らかのエラーが発生したときは関数は失敗しヌル ポインタを返します。ファイル終端かエラーかはf_eof/f_error関数で調べられます。

-

Unicode API構成(_LFN_UNICODE == 1)が選択されているときは、buffはUTF-16文字列になりますが、ファイル上のエンコードは、_STRF_ENCODEオプションで選択できます。それ以外の時は無変換(1バイト/1文字)で読み出します。

-
- - -
-

対応情報

-

この関数はf_read関数のラッパー関数です。_USE_STRFUNCが1または2のとき使用可能です。2のときは、ファイルに含まれる'\r'が取り除かれてバッファに読み込まれます。

-
- - -
-

参照

-

f_open, f_read, f_putc, f_puts, f_printf, f_close, FIL

-
- -

戻る

- -