]> cloudbase.mooo.com Git - z180-stamp.git/blobdiff - fatfs/doc/ja/sfile.html
Merge branch 'chan-fatfs' into fatfs-integration
[z180-stamp.git] / fatfs / doc / ja / sfile.html
index 5da60f96d6a193e92876a27df407893852ed3d79..da6bc6a26f519ecc928a456aeec4807f74bc6672 100644 (file)
 \r
 <div class="para">\r
 <h2>FIL</h2>\r
-<p><tt>FIL</tt>構造体(ファイル オブジェクト)は、<tt>f_open()</tt>で初期化され、以後そのファイルの状態を保持します。また、<tt>f_close()</tt>でファイルが閉じられると無効化されます。アプリケーションは、この構造体のメンバを書き換えてはなりません(<tt>cltbl</tt>は例外)。非タイニー構成(<tt>_FS_TINY == 0</tt>)では、内部に<tt>_MAX_SS</tt>バイトのセクタ バッファが確保されるので、そのサイズには注意が必要です。</p>\r
+<p><tt>FIL</tt>構造体(ファイル オブジェクト)は、<tt>f_open</tt>関数で初期化され、以後そのファイルの状態を保持します。また、<tt>f_close</tt>関数でファイルが閉じられると無効化されます。アプリケーションは、この構造体のメンバを書き換えてはなりません(<tt>cltbl</tt>は例外)。非タイニー構成(<tt>_FS_TINY == 0</tt>)では、内部に<tt>_MAX_SS</tt>バイトのセクタ バッファが確保されるので、そのサイズには注意が必要です。</p>\r
 \r
 <pre>\r
 <span class="k">typedef</span> <span class="k">struct</span> {\r
-    FATFS*  fs;           <span class="c">/* 親ファイル システム オブジェクトへのポインタ */</span>\r
-    WORD    id;           <span class="c">/* 親ファイル システム オブジェクトのマウントID */</span>\r
+    _FDID   obj;          <span class="c">/* オブジェクトID */</span>\r
     BYTE    flag;         <span class="c">/* ファイル ステータス フラグ */</span>\r
     BYTE    err;          <span class="c">/* エラー中断フラグ */</span>\r
-    DWORD   fptr;         <span class="c">/* ファイル読み書きポインタ (ファイル先頭からのバイト オフセット) */</span>\r
-    DWORD   fsize;        <span class="c">/* ファイル サイズ(バイト単位) */</span>\r
-    DWORD   sclust;       <span class="c">/* ファイル開始クラスタ番号 (0:割り当て無し) */</span>\r
-    DWORD   clust;        <span class="c">/* 現在のクラスタ */</span>\r
+    FSIZE_t fptr;         <span class="c">/* ファイル読み書きポインタ (ファイル先頭からのバイト オフセット) */</span>\r
+    DWORD   clust;        <span class="c">/* 現在のクラスタ (fptrがクラスタ境界上のときは前のクラスタ、fptrが0のときは無効) */</span>\r
     DWORD   dsect;        <span class="c">/* 現在のデータ セクタ */</span>\r
 <span class="k">#if</span> !_FS_READONLY\r
     DWORD   dir_sect;     <span class="c">/* このファイルのディレクトリ エントリのあるセクタ */</span>\r
@@ -37,7 +34,7 @@
     UINT    lockid;       <span class="c">/* ファイル ロックID */</span>\r
 <span class="k">#endif</span>\r
 <span class="k">#if</span> !_FS_TINY\r
-    BYTE    buf[_MAX_SS]; <span class="c">/* ファイル プライベート データ転送バッファ */</span>\r
+    BYTE    buf[_MAX_SS]; <span class="c">/* ファイル プライベート データ転送バッファ (fptrがセクタ境界上にない時は常に有効だが、fptrがセクタ境界上のときは無効な場合がある) */</span>\r
 <span class="k">#endif</span>\r
 } FIL;\r
 </pre>\r