From 5366852335044c1e68a5c32548d3051cc943552f Mon Sep 17 00:00:00 2001 From: Leo C Date: Tue, 19 Aug 2014 15:31:33 +0200 Subject: Import fatfs R0.10b FatFs Module Source Files R0.10b Author: (C)ChaN, 2014 (http://elm-chan.org) URL: http://elm-chan.org/fsw/ff/ff10b.zip --- fatfs/doc/ja/gets.html | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 fatfs/doc/ja/gets.html (limited to 'fatfs/doc/ja/gets.html') diff --git a/fatfs/doc/ja/gets.html b/fatfs/doc/ja/gets.html new file mode 100644 index 0000000..2babef0 --- /dev/null +++ b/fatfs/doc/ja/gets.html @@ -0,0 +1,65 @@ + + + + + + + + +FatFs - f_gets + + + + +
+

f_gets

+

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

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

引数

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

戻り値

+

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

+
+ + +
+

解説

+

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

+

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

+
+ + +
+

対応情報

+

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

+
+ + +
+

参照

+

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

+
+ +

戻る

+ + -- cgit v1.2.3