fatfs v0.08b Jan 15,2011:

- Fast seek feature is also applied to f_read() and f_write().
- f_lseek() reports required table size on creating CLMP.
- Extended format syntax of f_printf function.
- Ignores duplicated directory separators in given path names.
This commit is contained in:
savelij13 committed 2025-09-11 09:45:45 +03:00
1 parent 625f3adcbb
commit 5fa1073a5a
98 files changed
+2819 -2235

No files matched your search

+19 -24
View File
@@ -11,20 +11,20 @@
<body>
<div class="para">
<div class="para func">
<h2>f_read</h2>
<p>ファイルからデータを読み出します。</p>
<pre>
FRESULT f_read (
FIL* <em>FileObject</em>, <span>/* ファイル・オブジェクト構造体 */</span>
void* <em>Buffer</em>, <span>/* 読み出したデータを格納するバッファ */</span>
UINT <em>ByteToRead</em>, <span>/* 読み出すバイト数 */</span>
UINT* <em>ByteRead</em> <span>/* 読み出されたバイト数 */</span>
FIL* <em>FileObject</em>, <span class="c">/* ファイル・オブジェクト構造体 */</span>
void* <em>Buffer</em>, <span class="c">/* 読み出したデータを格納するバッファ */</span>
UINT <em>ByteToRead</em>, <span class="c">/* 読み出すバイト数 */</span>
UINT* <em>ByteRead</em> <span class="c">/* 読み出されたバイト数 */</span>
);
</pre>
</div>
<div class="para">
<div class="para arg">
<h4>引数</h4>
<dl class="par">
<dt>FileObject</dt>
@@ -39,38 +39,33 @@ FRESULT f_read (
</div>
<div class="para">
<div class="para ret">
<h4>戻り値</h4>
<dl class="ret">
<dt>FR_OK (0)</dt>
<dd>正常終了。</dd>
<dt>FR_DENIED</dt>
<dd>非読み込みモードで開いたファイルから読み込もうとした。</dd>
<dt>FR_DISK_ERR</dt>
<dd>ディスク・エラーによる失敗。</dd>
<dt>FR_INT_ERR</dt>
<dd>不正なFAT構造または内部エラーによる失敗。</dd>
<dt>FR_NOT_READY</dt>
<dd>メディアがセットされていないなど、物理ドライブが動作不能状態。</dd>
<dt>FR_INVALID_OBJECT</dt>
<dd>無効なファイル・オブジェクト。</dd>
</dl>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
<a href="rc.html#ie">FR_INT_ERR</a>,
<a href="rc.html#nr">FR_NOT_READY</a>,
<a href="rc.html#de">FR_DENIED</a>,
<a href="rc.html#io">FR_INVALID_OBJECT</a>,
<a href="rc.html#tm">FR_TIMEOUT</a>
</p>
</div>
<div class="para">
<div class="para desc">
<h4>解説</h4>
<p>読み込み開始位置は、現在のリード/ライト・ポインタからになります。リード/ライト・ポインタは読み込まれたバイト数だけ進みます。関数が正常終了した後は、<tt>*ByteRead</tt>の値をチェックすべきです。<tt>*ByteRead</tt>が<tt>ByteToRead</tt>よりも小さいときは、読み込み中にファイルの終端に達したことを示しています。</p>
</div>
<div class="para">
<div class="para comp">
<h4>対応情報</h4>
<p>全ての構成で使用可能です。</p>
</div>
<div class="para">
<div class="para ref">
<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="gets.html">fgets</a>, <a href="write.html">f_write</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p>
</div>