fatfs v0.09b Jan 23,2013:

- Added f_getlabel() and f_setlabel(). (_USE_LABEL == 1)
This commit is contained in:
savelij13 committed 2025-09-11 09:51:27 +03:00
1 parent 030f12c942
commit 750225eb33
112 files changed
+1847 -1043

No files matched your search

+9 -9
View File
@@ -16,9 +16,9 @@
<p>The f_gets reads a string from the file.</p>
<pre>
TCHAR* f_gets (
TCHAR* <em>Str</em>, <span class="c">/* Read buffer */</span>
int <em>Size</em>, <span class="c">/* Size of the read buffer */</span>
FIL* <em>FileObject</em> <span class="c">/* File object */</span>
TCHAR* <span class="arg">buff</span>, <span class="c">/* [OUT] Read buffer */</span>
int <span class="arg">len</span>, <span class="c">/* [IN] Size of the read buffer */</span>
FIL* <span class="arg">fp</span> <span class="c">/* [IN] File object */</span>
);
</pre>
</div>
@@ -26,11 +26,11 @@ TCHAR* f_gets (
<div class="para arg">
<h4>Parameters</h4>
<dl class="par">
<dt>Str</dt>
<dt>buff</dt>
<dd>Pointer to read buffer to store the read string.</dd>
<dt>Size</dt>
<dt>len</dt>
<dd>Size of the read buffer in unit of character.</dd>
<dt>FileObject</dt>
<dt>fp</dt>
<dd>Pointer to the open file object structure.</dd>
</dl>
</div>
@@ -38,14 +38,14 @@ TCHAR* f_gets (
<div class="para ret">
<h4>Return Values</h4>
<p>When the function succeeded, <tt>Str</tt> will be returuned.</p>
<p>When the function succeeded, <tt class="arg">buff</tt> will be returuned.</p>
</div>
<div class="para desc">
<h4>Description</h4>
<p>The f_gets() is a wrapper function of <a href="read.html">f_read()</a>. The read operation continues until a <tt>'\n'</tt> is stored, reached end of the file or the buffer is filled with <tt>Size - 1</tt> characters. The read string is terminated with a <tt>'\0'</tt>. When no character to read or any error occured during read operation, f_gets() returns a null pointer. The end of file and error status can be examined with <tt>f_eof()</tt> and <tt>f_error()</tt> macros.</p>
<p>When the FatFs is configured to Unicode API (<tt>_LFN_UNICODE == 1</tt>), the file is read in UTF-8 encoding and stored it to the buffer in UCS-2. If not the case, the file will be read in one byte per character without any code conversion.</p>
<p>The <tt>f_gets()</tt> function is a wrapper function of <a href="read.html">f_read()</a> function. The read operation continues until a <tt>'\n'</tt> is stored, reached end of the file or the buffer is filled with <tt>len - 1</tt> characters. The read string is terminated with a <tt>'\0'</tt>. When no character to read or any error occured during read operation, it returns a null pointer. The status of eof and error can be examined with <tt>f_eof()</tt> and <tt>f_error()</tt> macros.</p>
<p>When the FatFs is configured to Unicode API (<tt>_LFN_UNICODE == 1</tt>), the file is read in assumption of UTF-8 encoding and stored it to the buffer in UCS-2. If not the case, the file will be read in one byte per character without any code conversion.</p>
</div>