ファイルのリード/ライト・ポインタを移動します。また、高速シーク機能使用時にはCLMT(後述)の作成にも使用します。
+繝輔ぃ繧､繝ｫ縺ｮ繝ｪ繝ｼ繝�/繝ｩ繧､繝� 繝昴う繝ｳ繧ｿ繧堤ｧｻ蜍輔＠縺ｾ縺吶ゅ∪縺溘�鬮倬溘す繝ｼ繧ｯ讖溯�ｽ菴ｿ逕ｨ譎ゅ↓縺ｯCLMT(蠕瑚ｿｰ)縺ｮ菴懈�舌↓繧ゆｽｿ逕ｨ縺励∪縺吶�
FRESULT f_lseek ( - FIL* fp, /* [IN] ファイル・オブジェクト構造体へのポインタ */ - DWORD ofs /* [IN] 移動先オフセット */ + FIL* fp, /* [IN] 繝輔ぃ繧､繝ｫ 繧ｪ繝悶ず繧ｧ繧ｯ繝域ｧ矩菴薙∈縺ｮ繝昴う繝ｳ繧ｿ */ + DWORD ofs /* [IN] 遘ｻ蜍募�医が繝輔そ繝�繝� */ );
FR_OK, FR_DISK_ERR, @@ -48,82 +48,82 @@ FRESULT f_lseek (
ファイルのリード/ライト・ポインタ(次に読み出し・書き込みされるバイトのオフセット)を移動します。オフセットの原点はファイル先頭です。書き込みモードでファイル・サイズより大きな値を指定すると、そこまでファイル・サイズが拡張され、拡張された部分のデータは未定義となります。データを遅延無く高速に書き込みたいときは、予めこの関数で必要なサイズまでファイル・サイズを拡張しておくと良いでしょう。f_lseek()が正常終了したあとは、リード/ライト・ポインタが正しく移動したかチェックするべきです。リード/ライト・ポインタが指定より小さいときは、次の原因が考えられます。
+繝輔ぃ繧､繝ｫ縺ｮ繝ｪ繝ｼ繝�/繝ｩ繧､繝� 繝昴う繝ｳ繧ｿ(谺｡縺ｫ隱ｭ縺ｿ蜃ｺ縺励�ｻ譖ｸ縺崎ｾｼ縺ｿ縺輔ｌ繧九ヰ繧､繝医�ｮ繧ｪ繝輔そ繝�繝�)繧堤ｧｻ蜍輔＠縺ｾ縺吶ゅが繝輔そ繝�繝医�ｮ蜴溽せ縺ｯ繝輔ぃ繧､繝ｫ蜈磯ｭ縺ｧ縺吶よ嶌縺崎ｾｼ縺ｿ繝｢繝ｼ繝峨〒繝輔ぃ繧､繝ｫ 繧ｵ繧､繧ｺ繧医ｊ螟ｧ縺阪↑蛟､繧呈欠螳壹☆繧九→縲√◎縺薙∪縺ｧ繝輔ぃ繧､繝ｫ 繧ｵ繧､繧ｺ縺梧僑蠑ｵ縺輔ｌ縲∵僑蠑ｵ縺輔ｌ縺滄Κ蛻�縺ｮ繝�繝ｼ繧ｿ縺ｯ譛ｪ螳夂ｾｩ縺ｨ縺ｪ繧翫∪縺吶ゅョ繝ｼ繧ｿ繧帝≦蟒ｶ辟｡縺城ｫ倬溘↓譖ｸ縺崎ｾｼ縺ｿ縺溘＞縺ｨ縺阪�ｯ縲∽ｺ医ａ縺薙�ｮ髢｢謨ｰ縺ｧ蠢�隕√↑繧ｵ繧､繧ｺ縺ｾ縺ｧ繝輔ぃ繧､繝ｫ 繧ｵ繧､繧ｺ繧呈僑蠑ｵ縺励※縺翫￥縺ｨ濶ｯ縺�縺ｧ縺励ｇ縺�縲�f_lseek()縺梧ｭ｣蟶ｸ邨ゆｺ�縺励◆縺ゅ→縺ｯ縲√Μ繝ｼ繝�/繝ｩ繧､繝� 繝昴う繝ｳ繧ｿ縺梧ｭ｣縺励￥遘ｻ蜍輔＠縺溘°繝√ぉ繝�繧ｯ縺吶ｋ縺ｹ縺阪〒縺吶ゅΜ繝ｼ繝�/繝ｩ繧､繝� 繝昴う繝ｳ繧ｿ縺梧欠螳壹ｈ繧雁ｰ上＆縺�縺ｨ縺阪�ｯ縲∵ｬ｡縺ｮ蜴溷屏縺瑚�縺医ｉ繧後∪縺吶�
_USE_FASTSEEKが1で、且つファイル・オブジェクトのcltblメンバがNULL以外(f_open()でNULLに設定される)のとき、高速シーク・モードになります。これはファイルのクラスタ配置情報(CLMT)をメモリ上に保持しておくことにより、FATにアクセスすることなく後方シークやロング・シークを高速に行う機能です。高速シーク・モードは、f_read()/f_wtite()の動作にも適用されます。高速シーク・モードではf_wtite()/f_lseek()によるファイル・サイズの拡張はできません。
-高速シーク動作を行う前に、CLMTを作成しておく必要があります。これを作成するには、まずCLMT格納バッファ(DWORD型配列)を準備し、cltblメンバにそのポインタをセットします。そして、配列の先頭要素にその配列のサイズ(要素数)を入れ、f_lseek()をofsにCREATE_LINKMAPを指定して呼び出します。関数が成功するとCLMTが作成され、以降のf_read()/f_write()/f_lseek()ではFATへのアクセスは発生しません。FR_NOT_ENOUGH_COREで失敗したときは配列サイズが不足で、先頭要素には実際に必要となる要素数が返されます。必要な要素数は、(ファイルの分割数 + 1) * 2 です。たとえば、ファイルが5つのフラグメントに分断されているときに必要な要素数は、12となります。
+_USE_FASTSEEK縺�1縺ｧ縲∽ｸ斐▽繝輔ぃ繧､繝ｫ 繧ｪ繝悶ず繧ｧ繧ｯ繝医�ｮcltbl繝｡繝ｳ繝舌′NULL莉･螟�(f_open()縺ｧNULL縺ｫ險ｭ螳壹＆繧後ｋ)縺ｮ縺ｨ縺阪�鬮倬溘す繝ｼ繧ｯ 繝｢繝ｼ繝峨↓縺ｪ繧翫∪縺吶ゅ％繧後�ｯ繝輔ぃ繧､繝ｫ縺ｮ繧ｯ繝ｩ繧ｹ繧ｿ驟咲ｽｮ諠�蝣ｱ(CLMT)繧偵Γ繝｢繝ｪ荳翫↓菫晄戟縺励※縺翫￥縺薙→縺ｫ繧医ｊ縲：AT縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺薙→縺ｪ縺丞ｾ梧婿繧ｷ繝ｼ繧ｯ繧�繝ｭ繝ｳ繧ｰ 繧ｷ繝ｼ繧ｯ繧帝ｫ倬溘↓陦後≧讖溯�ｽ縺ｧ縺吶るｫ倬溘す繝ｼ繧ｯ 繝｢繝ｼ繝峨�ｯ縲�f_read()/f_wtite()縺ｮ蜍穂ｽ懊↓繧る←逕ｨ縺輔ｌ縺ｾ縺吶るｫ倬溘す繝ｼ繧ｯ 繝｢繝ｼ繝峨〒縺ｯf_wtite()/f_lseek()縺ｫ繧医ｋ繝輔ぃ繧､繝ｫ 繧ｵ繧､繧ｺ縺ｮ諡｡蠑ｵ縺ｯ縺ｧ縺阪∪縺帙ｓ縲�
+鬮倬溘す繝ｼ繧ｯ蜍穂ｽ懊ｒ陦後≧蜑阪↓縲，LMT繧剃ｽ懈�舌＠縺ｦ縺翫￥蠢�隕√′縺ゅｊ縺ｾ縺吶ゅ％繧後ｒ菴懈�舌☆繧九↓縺ｯ縲√∪縺咾LMT譬ｼ邏阪ヰ繝�繝輔ぃ(DWORD蝙矩�榊��)繧呈ｺ門ｙ縺励�cltbl繝｡繝ｳ繝舌↓縺昴�ｮ繝昴う繝ｳ繧ｿ繧偵そ繝�繝医＠縺ｾ縺吶ゅ◎縺励※縲�驟榊�励�ｮ蜈磯ｭ隕∫ｴ縺ｫ縺昴�ｮ驟榊�励�ｮ繧ｵ繧､繧ｺ(隕∫ｴ謨ｰ)繧貞�･繧後�f_lseek()繧�ofs縺ｫCREATE_LINKMAP繧呈欠螳壹＠縺ｦ蜻ｼ縺ｳ蜃ｺ縺励∪縺吶る未謨ｰ縺梧�仙粥縺吶ｋ縺ｨCLMT縺御ｽ懈�舌＆繧後∽ｻ･髯阪�ｮf_read()/f_write()/f_lseek()縺ｧ縺ｯFAT縺ｸ縺ｮ繧｢繧ｯ繧ｻ繧ｹ縺ｯ逋ｺ逕溘＠縺ｾ縺帙ｓ縲�FR_NOT_ENOUGH_CORE縺ｧ螟ｱ謨励＠縺溘→縺阪�ｯ驟榊�励し繧､繧ｺ縺御ｸ崎ｶｳ縺ｧ縲∝�磯ｭ隕∫ｴ縺ｫ縺ｯ螳滄圀縺ｫ蠢�隕√→縺ｪ繧玖ｦ∫ｴ謨ｰ縺瑚ｿ斐＆繧後∪縺吶ょｿ�隕√↑隕∫ｴ謨ｰ縺ｯ縲�(繝輔ぃ繧､繝ｫ縺ｮ蛻�蜑ｲ謨ｰ + 1) * 2 縺ｧ縺吶ゅ◆縺ｨ縺医�ｰ縲√ヵ繧｡繧､繝ｫ縺�5縺､縺ｮ繝輔Λ繧ｰ繝｡繝ｳ繝医↓蛻�譁ｭ縺輔ｌ縺ｦ縺�繧九→縺阪↓蠢�隕√↑隕∫ｴ謨ｰ縺ｯ縲�12縺ｨ縺ｪ繧翫∪縺吶�
_FS_MINIMIZE < 3のとき使用可能です。
+_FS_MINIMIZE < 3縺ｮ縺ｨ縺堺ｽｿ逕ｨ蜿ｯ閭ｽ縺ｧ縺吶�
- /* ファイルを開く */ + /* 繝輔ぃ繧､繝ｫ繧帝幕縺� */ fp = malloc(sizeof (FIL)); res = f_open(fp, "file.dat", FA_READ|FA_WRITE); if (res) ... - /* ファイル・オフセット5000へ移動 */ + /* 繝輔ぃ繧､繝ｫ 繧ｪ繝輔そ繝�繝�5000縺ｸ遘ｻ蜍� */ res = f_lseek(fp, 5000); - /* ファイル終端へ移動(ファイル追記の準備) */ + /* 繝輔ぃ繧､繝ｫ邨らｫｯ縺ｸ遘ｻ蜍�(繝輔ぃ繧､繝ｫ霑ｽ險倥�ｮ貅門ｙ) */ res = f_lseek(fp, f_size(fp)); - /* 3000バイト進める */ + /* 3000繝舌う繝磯ｲ繧√ｋ */ res = f_lseek(fp, f_tell(fp) + 3000); - /* 2000バイト戻す (ラップアラウンドに注意) */ + /* 2000繝舌う繝域綾縺� (繝ｩ繝�繝励い繝ｩ繧ｦ繝ｳ繝峨↓豕ｨ諢�) */ res = f_lseek(fp, f_tell(fp) - 2000);
-/* クラスタ先行割り当て (ストリーミング・ライト時のバッファ・オーバーラン防止) */ +/* 繧ｯ繝ｩ繧ｹ繧ｿ蜈郁｡悟牡繧雁ｽ薙※ (繧ｹ繝医Μ繝ｼ繝溘Φ繧ｰ 繝ｩ繧､繝域凾縺ｮ繝舌ャ繝輔ぃ 繧ｪ繝ｼ繝舌�ｼ繝ｩ繝ｳ髦ｲ豁｢) */ - res = f_open(fp, "record.wav", FA_CREATE_NEW | FA_WRITE); /* ファイル作成 */ + res = f_open(fp, "record.wav", FA_CREATE_NEW | FA_WRITE); /* 繝輔ぃ繧､繝ｫ菴懈�� */ - res = f_lseek(fp, MAX_SIZE); /* 十分なクラスタの先行割り当て */ - if (res || f_tell(fp) != PRE_SIZE) ... /* 正しくファイルが拡張されたかチェック */ + res = f_lseek(fp, MAX_SIZE); /* 蜊∝��縺ｪ繧ｯ繝ｩ繧ｹ繧ｿ縺ｮ蜈郁｡悟牡繧雁ｽ薙※ */ + if (res || f_tell(fp) != PRE_SIZE) ... /* 豁｣縺励￥繝輔ぃ繧､繝ｫ縺梧僑蠑ｵ縺輔ｌ縺溘°繝√ぉ繝�繧ｯ */ - res = f_lseek(fp, DATA_START); /* データ・ストリームの記録(アロケーションディレイ無し) */ + res = f_lseek(fp, DATA_START); /* 繝�繝ｼ繧ｿ 繧ｹ繝医Μ繝ｼ繝縺ｮ險倬鹸(繧｢繝ｭ繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ繝�繧｣繝ｬ繧､辟｡縺�) */ ... - res = f_truncate(fp); /* 不要領域の切り捨て */ - res = f_lseek(fp, 0); /* ヘッダの記録 */ + res = f_truncate(fp); /* 荳崎ｦ�鬆伜沺縺ｮ蛻�繧頑昏縺ｦ */ + res = f_lseek(fp, 0); /* 繝倥ャ繝縺ｮ險倬鹸 */ ... res = f_close(fp);
-/* 高速シーク機能を使う */ +/* 鬮倬溘す繝ｼ繧ｯ讖溯�ｽ繧剃ｽｿ縺� */ - DWORD clmt[SZ_TBL]; /* リンク・マップ・テーブル格納バッファ */ + DWORD clmt[SZ_TBL]; /* 繝ｪ繝ｳ繧ｯ 繝槭ャ繝� 繝�繝ｼ繝悶Ν譬ｼ邏阪ヰ繝�繝輔ぃ */ - res = f_lseek(fp, ofs1); /* 通常シーク (オープン時、cltblはNULLに初期化される) */ + res = f_lseek(fp, ofs1); /* 騾壼ｸｸ繧ｷ繝ｼ繧ｯ (繧ｪ繝ｼ繝励Φ譎ゅ…ltbl縺ｯNULL縺ｫ蛻晄悄蛹悶＆繧後ｋ) */ - fp->cltbl = clmt; /* 高速シーク機能の有効化 */ - clmt[0] = SZ_TBL; /* 先頭要素に配列要素数をセット */ - res = f_lseek(fp, CREATE_LINKMAP); /* CLMTの作成 */ + fp->cltbl = clmt; /* 鬮倬溘す繝ｼ繧ｯ讖溯�ｽ縺ｮ譛牙柑蛹� */ + clmt[0] = SZ_TBL; /* 蜈磯ｭ隕∫ｴ縺ｫ驟榊�苓ｦ∫ｴ謨ｰ繧偵そ繝�繝� */ + res = f_lseek(fp, CREATE_LINKMAP); /* CLMT縺ｮ菴懈�� */ ... - res = f_lseek(fp, ofs2); /* 以降、f_read/f_write/f_lseekでFATアクセスは発生しない */ + res = f_lseek(fp, ofs2); /* 莉･髯阪’_read/f_write/f_lseek縺ｧFAT繧｢繧ｯ繧ｻ繧ｹ縺ｯ逋ｺ逕溘＠縺ｪ縺� */