<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">\r
<html lang="ja">\r
<head>\r
-<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">\r
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">\r
<meta http-equiv="Content-Style-Type" content="text/css">\r
<link rel="up" title="FatFs" href="../00index_j.html">\r
<link rel="alternate" hreflang="en" title="English" href="../en/gets.html">\r
\r
<div class="para func">\r
<h2>f_gets</h2>\r
-<p>\83t\83@\83C\83\8b\82©\82ç\95¶\8e\9a\97ñ\82ð\93Ç\82Ý\8fo\82µ\82Ü\82·\81B</p>\r
+<p>ファイルから文字列を読み出します。</p>\r
<pre>\r
TCHAR* f_gets (\r
- TCHAR* <span class="arg">buff</span>, <span class="c">/* [OUT] \83o\83b\83t\83@ */</span>\r
- int <span class="arg">len</span>, <span class="c">/* [IN] \83o\83b\83t\83@\82Ì\83T\83C\83Y */</span>\r
- FIL* <span class="arg">fp</span> <span class="c">/* [IN] \83t\83@\83C\83\8b\81E\83I\83u\83W\83F\83N\83g */</span>\r
+ TCHAR* <span class="arg">buff</span>, <span class="c">/* [OUT] バッファ */</span>\r
+ int <span class="arg">len</span>, <span class="c">/* [IN] バッファのサイズ */</span>\r
+ FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span>\r
);\r
</pre>\r
</div>\r
\r
<div class="para arg">\r
-<h4>\88ø\90\94</h4>\r
+<h4>引数</h4>\r
<dl class="par">\r
<dt>buff</dt>\r
-<dd>\95¶\8e\9a\97ñ\82ð\93Ç\82Ý\8fo\82·\83o\83b\83t\83@\82ð\8ew\82·\83|\83C\83\93\83^\82ð\8ew\92è\82µ\82Ü\82·\81B</dd>\r
+<dd>文字列を読み出すバッファを指すポインタを指定します。</dd>\r
<dt>len</dt>\r
-<dd>\83o\83b\83t\83@\82Ì\83T\83C\83Y\82ð\97v\91f\90\94\82Å\8ew\92è\82µ\82Ü\82·\81B</dd>\r
+<dd>バッファのサイズを要素数で指定します。</dd>\r
<dt>fp</dt>\r
-<dd>\83t\83@\83C\83\8b\81E\83I\83u\83W\83F\83N\83g\8d\\91¢\91Ì\82Ö\82Ì\83|\83C\83\93\83^\82ð\8ew\92è\82µ\82Ü\82·\81B</dd>\r
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>\r
</dl>\r
</div>\r
\r
\r
<div class="para ret">\r
-<h4>\96ß\82è\92l</h4>\r
-<p>\8aÖ\90\94\82ª\90¬\8c÷\82·\82é\82Æ<tt class="arg">buff</tt>\82ª\95Ô\82³\82ê\82Ü\82·\81B</p>\r
+<h4>戻り値</h4>\r
+<p>関数が成功すると<tt class="arg">buff</tt>が返されます。</p>\r
</div>\r
\r
\r
<div class="para desc">\r
-<h4>\89ð\90à</h4>\r
-<p>\82±\82Ì\8aÖ\90\94\82Í<a href="read.html"><tt>f_read()</tt></a>\82Ì\83\89\83b\83p\81[\8aÖ\90\94\82Å\82·\81B\93Ç\82Ý\8fo\82µ\93®\8dì\82Í\81A\8dÅ\8f\89\82Ì<tt>'\n'</tt>\82ð\93Ç\82Ý\8d\9e\82Þ\82©\81A\83t\83@\83C\83\8b\8fI\92[\82É\92B\82·\82é\82©\81A<tt class="arg">len</tt> - 1\95¶\8e\9a\82ð\93Ç\82Ý\8fo\82·\82Ü\82Å\91±\82«\82Ü\82·\81B\93Ç\82Ý\8d\9e\82Ü\82ê\82½\95¶\8e\9a\97ñ\82Ì\8fI\92[\82É\82Í<tt>'\0'</tt>\82ª\95t\89Á\82³\82ê\82Ü\82·\81B\8aù\82É\83t\83@\83C\83\8b\8fI\92[\82Å1\95¶\8e\9a\82à\93Ç\82Ý\8d\9e\82Ü\82ê\82È\82©\82Á\82½\82Æ\82«\81A\82Ü\82½\82Í\89½\82ç\82©\82Ì\83G\83\89\81[\82ª\94\90¶\82µ\82½\82Æ\82«\82Í\8aÖ\90\94\82Í\8e¸\94s\82µ\83k\83\8b\81E\83|\83C\83\93\83^\82ð\95Ô\82µ\82Ü\82·\81B\83t\83@\83C\83\8b\8fI\92[\82©\83G\83\89\81[\82©\82Í<tt>f_eof()</tt>,<tt>f_error()</tt>\83}\83N\83\8d\82Å\92²\82×\82ç\82ê\82Ü\82·\81B</p>\r
-<p>Unicode API\8d\\90¬(<tt>_LFN_UNICODE == 1</tt>)\82ª\91I\91ð\82³\82ê\82Ä\82¢\82é\82Æ\82«\82Í\81A<tt class="arg">buff</tt>\82ÍUTF-16\95¶\8e\9a\97ñ\82É\82È\82è\82Ü\82·\82ª\81A\83t\83@\83C\83\8b\8fã\82Ì\83G\83\93\83R\81[\83h\82Í\81A<tt>_STRF_ENCODE</tt>\83I\83v\83V\83\87\83\93\82Å\91I\91ð\82Å\82«\82Ü\82·\81B\82»\82ê\88È\8aO\82Ì\8e\9e\82Í\96³\95Ï\8a·(1\83o\83C\83g/1\95¶\8e\9a)\82Å\93Ç\82Ý\8fo\82µ\82Ü\82·\81B</p>\r
+<h4>解説</h4>\r
+<p>読み出し動作は、最初の<tt>'\n'</tt>を読み込むか、ファイル終端に達するか、<tt class="arg">len</tt> - 1文字を読み出すまで続きます。読み込まれた文字列の終端には<tt>'\0'</tt>が付加されます。既にファイル終端で1文字も読み込まれなかったとき、または何らかのエラーが発生したときは関数は失敗しヌル ポインタを返します。ファイル終端かエラーかは<tt>f_eof/f_error</tt>関数で調べられます。</p>\r
+<p>Unicode API構成(<tt>_LFN_UNICODE == 1</tt>)が選択されているときは、<tt class="arg">buff</tt>はUTF-16文字列になりますが、ファイル上のエンコードは、<tt>_STRF_ENCODE</tt>オプションで選択できます。それ以外の時は無変換(1バイト/1文字)で読み出します。</p>\r
</div>\r
\r
\r
<div class="para comp">\r
-<h4>\91Î\89\9e\8fî\95ñ</h4>\r
-<p><tt>_USE_STRFUNC</tt>\82ª1\82Ü\82½\82Í2\82Ì\82Æ\82«\8eg\97p\89Â\94\\82Å\82·\81B2\82Ì\82Æ\82«\82Í\81A\83t\83@\83C\83\8b\82É\8aÜ\82Ü\82ê\82é<tt>'\r'</tt>\82ª\8eæ\82è\8f\9c\82©\82ê\82Ä\83o\83b\83t\83@\82É\93Ç\82Ý\8d\9e\82Ü\82ê\82Ü\82·\81B</p>\r
+<h4>対応情報</h4>\r
+<p>この関数は<a href="read.html"><tt>f_read</tt></a>関数のラッパー関数です。<tt>_USE_STRFUNC</tt>が1または2のとき使用可能です。2のときは、ファイルに含まれる<tt>'\r'</tt>が取り除かれてバッファに読み込まれます。</p>\r
</div>\r
\r
\r
<div class="para ref">\r
-<h4>\8eQ\8fÆ</h4>\r
+<h4>参照</h4>\r
<p><tt><a href="open.html">f_open</a>, <a href="read.html">f_read</a>, <a href="putc.html">f_putc</a>, <a href="puts.html">f_puts</a>, <a href="printf.html">f_printf</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p>\r
</div>\r
\r
-<p class="foot"><a href="../00index_j.html">\96ß\82é</a></p>\r
+<p class="foot"><a href="../00index_j.html">戻る</a></p>\r
</body>\r
</html>\r
projects / z180-stamp.git / blobdiff