X-Git-Url: http://cloudbase.mooo.com/gitweb/z180-stamp.git/blobdiff_plain/4bc81323e51ac138e733c14eeb6f283ae706e904..05437fb4cdb907816a4fc3ffafa2617fcf33266a:/fatfs/doc/ja/gets.html diff --git a/fatfs/doc/ja/gets.html b/fatfs/doc/ja/gets.html index 2babef0..74e0b22 100644 --- a/fatfs/doc/ja/gets.html +++ b/fatfs/doc/ja/gets.html @@ -1,7 +1,7 @@ - + @@ -13,53 +13,53 @@

f_gets

-

ƒtƒ@ƒCƒ‹‚©‚當Žš—ñ‚ð“ǂݏo‚µ‚Ü‚·B

+

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

 TCHAR* f_gets (
-  TCHAR* buff, /* [OUT] ƒoƒbƒtƒ@ */
-  int len,     /* [IN] ƒoƒbƒtƒ@‚̃TƒCƒY */
-  FIL* fp      /* [IN] ƒtƒ@ƒCƒ‹EƒIƒuƒWƒFƒNƒg */
+  TCHAR* buff, /* [OUT] バッファ */
+  int len,     /* [IN] バッファのサイズ */
+  FIL* fp      /* [IN] ファイル オブジェクト */
 );
 
-

ˆø”

+

引数

buff
-
•¶Žš—ñ‚ð“ǂݏo‚·ƒoƒbƒtƒ@‚ðŽw‚·ƒ|ƒCƒ“ƒ^‚ðŽw’肵‚Ü‚·B
+
文字列を読み出すバッファを指すポインタを指定します。
len
-
ƒoƒbƒtƒ@‚̃TƒCƒY‚ð—v‘f”‚ÅŽw’肵‚Ü‚·B
+
バッファのサイズを要素数で指定します。
fp
-
ƒtƒ@ƒCƒ‹EƒIƒuƒWƒFƒNƒg\‘¢‘̂ւ̃|ƒCƒ“ƒ^‚ðŽw’肵‚Ü‚·B
+
ファイル オブジェクト構造体へのポインタを指定します。
-

–ß‚è’l

-

ŠÖ”‚ª¬Œ÷‚·‚é‚Æbuff‚ª•Ô‚³‚ê‚Ü‚·B

+

戻り値

+

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

-

‰ðà

-

‚±‚̊֐”‚Íf_read()‚̃‰ƒbƒp[ŠÖ”‚Å‚·B“ǂݏo‚µ“®ì‚́AÅ‰‚Ì'\n'‚ð“ǂݍž‚Þ‚©Aƒtƒ@ƒCƒ‹I’[‚É’B‚·‚é‚©Alen - 1•¶Žš‚ð“ǂݏo‚·‚Ü‚Å‘±‚«‚Ü‚·B“ǂݍž‚܂ꂽ•¶Žš—ñ‚̏I’[‚É‚Í'\0'‚ª•t‰Á‚³‚ê‚Ü‚·BŠù‚Ƀtƒ@ƒCƒ‹I’[‚Å1•¶Žš‚à“ǂݍž‚Ü‚ê‚È‚©‚Á‚½‚Æ‚«A‚Ü‚½‚͉½‚ç‚©‚̃Gƒ‰[‚ª”­¶‚µ‚½‚Æ‚«‚͊֐”‚ÍŽ¸”s‚µƒkƒ‹Eƒ|ƒCƒ“ƒ^‚ð•Ô‚µ‚Ü‚·Bƒtƒ@ƒCƒ‹I’[‚©ƒGƒ‰[‚©‚Íf_eof(),f_error()ƒ}ƒNƒ‚Å’²‚ׂç‚ê‚Ü‚·B

-

Unicode API\¬(_LFN_UNICODE == 1)‚ª‘I‘ð‚³‚ê‚Ä‚¢‚é‚Æ‚«‚́Abuff‚ÍUTF-16•¶Žš—ñ‚É‚È‚è‚Ü‚·‚ªAƒtƒ@ƒCƒ‹ã‚̃Gƒ“ƒR[ƒh‚́A_STRF_ENCODEƒIƒvƒVƒ‡ƒ“‚Å‘I‘ð‚Å‚«‚Ü‚·B‚»‚êˆÈŠO‚ÌŽž‚Í–³•ÏŠ·(1ƒoƒCƒg/1•¶Žš)‚œǂݏo‚µ‚Ü‚·B

+

解説

+

この関数は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‚Ì‚Æ‚«Žg—p‰Â”\‚Å‚·B2‚Ì‚Æ‚«‚́Aƒtƒ@ƒCƒ‹‚ÉŠÜ‚Ü‚ê‚é'\r'‚ªŽæ‚菜‚©‚ê‚ăoƒbƒtƒ@‚ɓǂݍž‚Ü‚ê‚Ü‚·B

+

対応情報

+

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

-

ŽQÆ

+

参照

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

-

–ß‚é

+

戻る