ファイルをオープンまたは作成します。
+繝輔ぃ繧､繝ｫ繧偵が繝ｼ繝励Φ縺ｾ縺溘�ｯ菴懈�舌＠縺ｾ縺吶�
FRESULT f_open ( - FIL* fp, /* [OUT] 空のファイル・オブジェクト構造体へのポインタ */ - const TCHAR* path, /* [IN] ファイル名へのポインタ */ - BYTE mode /* [IN] モードフラグ */ + FIL* fp, /* [OUT] 遨ｺ縺ｮ繝輔ぃ繧､繝ｫ 繧ｪ繝悶ず繧ｧ繧ｯ繝域ｧ矩菴薙∈縺ｮ繝昴う繝ｳ繧ｿ */ + const TCHAR* path, /* [IN] 繝輔ぃ繧､繝ｫ蜷阪∈縺ｮ繝昴う繝ｳ繧ｿ */ + BYTE mode /* [IN] 繝｢繝ｼ繝峨ヵ繝ｩ繧ｰ */ );
| 値 | 意味 |
|---|---|
| FA_READ | 読み出しモードで開きます。読み書きする場合はFA_WRITEと共に指定します。 |
| FA_WRITE | 書き込みモードで開きます。読み書きする場合はFA_READと共に指定します。 |
| FA_OPEN_EXISTING | 既存のファイルを開きます。ファイルが無いときはエラーになります。(デフォルト) |
| FA_OPEN_ALWAYS | 既存のファイルを開きます。ファイルが無いときはファイルを作成します。追記の場合は、この方法でオープンした後、f_lseek()でファイルの最後尾に移動してください。 |
| FA_CREATE_NEW | ファイルを作成します。同名のファイルがある場合は、FR_EXISTで失敗します。 |
| FA_CREATE_ALWAYS | ファイルを作成します。同名のファイルがある場合は、サイズを0にしてから開きます。 |
| 蛟､ | 諢丞袖 |
| FA_READ | 隱ｭ縺ｿ蜃ｺ縺励Δ繝ｼ繝峨〒髢九″縺ｾ縺吶りｪｭ縺ｿ譖ｸ縺阪☆繧句ｴ蜷医�ｯFA_WRITE縺ｨ蜈ｱ縺ｫ謖�螳壹＠縺ｾ縺吶� |
| FA_WRITE | 譖ｸ縺崎ｾｼ縺ｿ繝｢繝ｼ繝峨〒髢九″縺ｾ縺吶りｪｭ縺ｿ譖ｸ縺阪☆繧句ｴ蜷医�ｯFA_READ縺ｨ蜈ｱ縺ｫ謖�螳壹＠縺ｾ縺吶� |
| FA_OPEN_EXISTING | 譌｢蟄倥�ｮ繝輔ぃ繧､繝ｫ繧帝幕縺阪∪縺吶ゅヵ繧｡繧､繝ｫ縺檎┌縺�縺ｨ縺阪�ｯ繧ｨ繝ｩ繝ｼ縺ｫ縺ｪ繧翫∪縺吶�(繝�繝輔か繝ｫ繝�) |
| FA_OPEN_ALWAYS | 譌｢蟄倥�ｮ繝輔ぃ繧､繝ｫ繧帝幕縺阪∪縺吶ゅヵ繧｡繧､繝ｫ縺檎┌縺�縺ｨ縺阪�ｯ繝輔ぃ繧､繝ｫ繧剃ｽ懈�舌＠縺ｾ縺吶りｿｽ險倥�ｮ蝣ｴ蜷医�ｯ縲√％縺ｮ譁ｹ豕輔〒繧ｪ繝ｼ繝励Φ縺励◆蠕後�f_lseek()縺ｧ繝輔ぃ繧､繝ｫ縺ｮ譛蠕悟ｰｾ縺ｫ遘ｻ蜍輔＠縺ｦ縺上□縺輔＞縲� |
| FA_CREATE_NEW | 繝輔ぃ繧､繝ｫ繧剃ｽ懈�舌＠縺ｾ縺吶ょ酔蜷阪�ｮ繝輔ぃ繧､繝ｫ縺後≠繧句ｴ蜷医�ｯ縲�FR_EXIST縺ｧ螟ｱ謨励＠縺ｾ縺吶� |
| FA_CREATE_ALWAYS | 繝輔ぃ繧､繝ｫ繧剃ｽ懈�舌＠縺ｾ縺吶ょ酔蜷阪�ｮ繝輔ぃ繧､繝ｫ縺後≠繧句ｴ蜷医�ｯ縲√し繧､繧ｺ繧�0縺ｫ縺励※縺九ｉ髢九″縺ｾ縺吶� |
FR_OK, FR_DISK_ERR, @@ -72,86 +72,86 @@ FRESULT f_open (
既存のファイルを開いたり、新しいファイルを作成します。関数が成功するとファイル・オブジェクトが作成され、以降そのファイルに対するアクセスに使用します。ファイルを閉じるときは、f_close()を使用します。何らかの変更が行われたファイルがその後正しく閉じられなかった場合、そのファイルが破損する場合があります。
-既に開かれているファイルを開く必要がある場合は、多重アクセス制御を参照してください。しかし、一つのファイルに対する書き込みモードを含む重複オープンは常に禁止です。
-ファイル・アクセスを開始する前に、f_mount()を使ってそれぞれの論理ドライブにワーク・エリア(ファイル・システム・オブジェクト)を与える必要があります。この初期化の後、その論理ドライブに対して全てのファイル関数が使えるようになります。
+譌｢蟄倥�ｮ繝輔ぃ繧､繝ｫ繧帝幕縺�縺溘ｊ縲∵眠縺励＞繝輔ぃ繧､繝ｫ繧剃ｽ懈�舌＠縺ｾ縺吶る未謨ｰ縺梧�仙粥縺吶ｋ縺ｨ繝輔ぃ繧､繝ｫ 繧ｪ繝悶ず繧ｧ繧ｯ繝医′菴懈�舌＆繧後∽ｻ･髯阪◎縺ｮ繝輔ぃ繧､繝ｫ縺ｫ蟇ｾ縺吶ｋ繧｢繧ｯ繧ｻ繧ｹ縺ｫ菴ｿ逕ｨ縺励∪縺吶ゅヵ繧｡繧､繝ｫ繧帝哩縺倥ｋ縺ｨ縺阪�ｯ縲�f_close()繧剃ｽｿ逕ｨ縺励∪縺吶ゆｽ輔ｉ縺九�ｮ螟画峩縺瑚｡後ｏ繧後◆繝輔ぃ繧､繝ｫ縺後◎縺ｮ蠕梧ｭ｣縺励￥髢峨§繧峨ｌ縺ｪ縺九▲縺溷ｴ蜷医√◎縺ｮ繝輔ぃ繧､繝ｫ縺檎ｴ謳阪☆繧句ｴ蜷医′縺ゅｊ縺ｾ縺吶�
+譌｢縺ｫ髢九°繧後※縺�繧九ヵ繧｡繧､繝ｫ繧帝幕縺丞ｿ�隕√′縺ゅｋ蝣ｴ蜷医�ｯ縲�螟夐㍾繧｢繧ｯ繧ｻ繧ｹ蛻ｶ蠕｡繧貞盾辣ｧ縺励※縺上□縺輔＞縲ゅ＠縺九＠縲∽ｸ縺､縺ｮ繝輔ぃ繧､繝ｫ縺ｫ蟇ｾ縺吶ｋ譖ｸ縺崎ｾｼ縺ｿ繝｢繝ｼ繝峨ｒ蜷ｫ繧驥崎､�繧ｪ繝ｼ繝励Φ縺ｯ蟶ｸ縺ｫ遖∵ｭ｢縺ｧ縺吶�
+繝輔ぃ繧､繝ｫ 繧｢繧ｯ繧ｻ繧ｹ繧帝幕蟋九☆繧句燕縺ｫ縲�f_mount()繧剃ｽｿ縺｣縺ｦ縺昴ｌ縺槭ｌ縺ｮ隲也炊繝峨Λ繧､繝悶↓繝ｯ繝ｼ繧ｯ 繧ｨ繝ｪ繧｢(繝輔ぃ繧､繝ｫ 繧ｷ繧ｹ繝�繝 繧ｪ繝悶ず繧ｧ繧ｯ繝�)繧剃ｸ弱∴繧句ｿ�隕√′縺ゅｊ縺ｾ縺吶ゅ％縺ｮ蛻晄悄蛹悶�ｮ蠕後√◎縺ｮ隲也炊繝峨Λ繧､繝悶↓蟇ｾ縺励※蜈ｨ縺ｦ縺ｮ繝輔ぃ繧､繝ｫ髢｢謨ｰ縺御ｽｿ縺医ｋ繧医≧縺ｫ縺ｪ繧翫∪縺吶�
全ての構成で使用可能です。_FS_READONLY == 1のときは、FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYSの各フラグはサポートされません。
+蜈ｨ縺ｦ縺ｮ讒区�舌〒菴ｿ逕ｨ蜿ｯ閭ｽ縺ｧ縺吶�_FS_READONLY == 1縺ｮ縺ｨ縺阪�ｯ縲�FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYS縺ｮ蜷�繝輔Λ繧ｰ縺ｯ繧ｵ繝昴�ｼ繝医＆繧後∪縺帙ｓ縲�
-/* テキストファイルを読み出して表示 */ +/* 繝�繧ｭ繧ｹ繝医ヵ繧｡繧､繝ｫ繧定ｪｭ縺ｿ蜃ｺ縺励※陦ｨ遉ｺ */ -FATFS FatFs; /* 論理ドライブのワーク・エリア(ファイル・システム・オブジェクト) */ +FATFS FatFs; /* 隲也炊繝峨Λ繧､繝悶�ｮ繝ｯ繝ｼ繧ｯ 繧ｨ繝ｪ繧｢(繝輔ぃ繧､繝ｫ 繧ｷ繧ｹ繝�繝 繧ｪ繝悶ず繧ｧ繧ｯ繝�) */ int main (void) { - FIL fil; /* ファイル・オブジェクト */ - char line[82]; /* 行バッファ */ - FRESULT fr; /* 戻り値 */ + FIL fil; /* 繝輔ぃ繧､繝ｫ 繧ｪ繝悶ず繧ｧ繧ｯ繝� */ + char line[82]; /* 陦後ヰ繝�繝輔ぃ */ + FRESULT fr; /* 謌ｻ繧雁､ */ - /* デフォルト・ドライブにワークエリアを与える */ + /* 繝�繝輔か繝ｫ繝� 繝峨Λ繧､繝悶↓繝ｯ繝ｼ繧ｯ繧ｨ繝ｪ繧｢繧剃ｸ弱∴繧� */ f_mount(&FatFs, "", 0); - /* テキスト・ファイルを開く */ + /* 繝�繧ｭ繧ｹ繝� 繝輔ぃ繧､繝ｫ繧帝幕縺� */ fr = f_open(&fil, "message.txt", FA_READ); if (fr) return (int)fr; - /* 1行ずつ読み出して表示 */ + /* 1陦後★縺､隱ｭ縺ｿ蜃ｺ縺励※陦ｨ遉ｺ */ while (f_gets(line, sizeof line, &fil)) printf(line); - /* ファイルを閉じる */ + /* 繝輔ぃ繧､繝ｫ繧帝哩縺倥ｋ */ f_close(&fil); return 0; }
-/* ドライブ1のファイル "file.bin" をドライブ0へコピー */ +/* 繝峨Λ繧､繝�1縺ｮ繝輔ぃ繧､繝ｫ "file.bin" 繧偵ラ繝ｩ繧､繝�0縺ｸ繧ｳ繝斐�ｼ */ int main (void) { - FATFS fs[2]; /* 論理ドライブのワークエリア(ファイル・システム・オブジェクト) */ - FIL fsrc, fdst; /* ファイル・オブジェクト */ + FATFS fs[2]; /* 隲也炊繝峨Λ繧､繝悶�ｮ繝ｯ繝ｼ繧ｯ繧ｨ繝ｪ繧｢(繝輔ぃ繧､繝ｫ 繧ｷ繧ｹ繝�繝 繧ｪ繝悶ず繧ｧ繧ｯ繝�) */ + FIL fsrc, fdst; /* 繝輔ぃ繧､繝ｫ 繧ｪ繝悶ず繧ｧ繧ｯ繝� */ BYTE buffer[4096]; /* File copy buffer */ FRESULT fr; /* FatFs function common result code */ UINT br, bw; /* File R/W count */ - /* ドライブ0,1にワーク・エリアを与える */ + /* 繝峨Λ繧､繝�0,1縺ｫ繝ｯ繝ｼ繧ｯ 繧ｨ繝ｪ繧｢繧剃ｸ弱∴繧� */ f_mount(&fs[0], "0:", 0); f_mount(&fs[1], "1:", 0); - /* ドライブ1のコピー元ファイルを開く */ + /* 繝峨Λ繧､繝�1縺ｮ繧ｳ繝斐�ｼ蜈�繝輔ぃ繧､繝ｫ繧帝幕縺� */ res = f_open(&fsrc, "1:file.dat", FA_OPEN_EXISTING | FA_READ); if (fr) return (int)fr; - /* ドライブ0にコピー先ファイルを作成する */ + /* 繝峨Λ繧､繝�0縺ｫ繧ｳ繝斐�ｼ蜈医ヵ繧｡繧､繝ｫ繧剃ｽ懈�舌☆繧� */ res = f_open(&fdst, "0:file.dat", FA_CREATE_ALWAYS | FA_WRITE); if (fr) return (int)fr; - /* コピー元からコピー先にデータ転送する */ + /* 繧ｳ繝斐�ｼ蜈�縺九ｉ繧ｳ繝斐�ｼ蜈医↓繝�繝ｼ繧ｿ霆｢騾√☆繧� */ for (;;) { - res = f_read(&fsrc, buffer, sizeof buffer, &br); /* コピー元からから読み出す */ - if (res || br == 0) break; /* エラーかファイル終端 */ - res = f_write(&fdst, buffer, br, &bw); /* それをコピー先に書き込む */ - if (res || bw < br) break; /* エラーかディスク満杯 */ + res = f_read(&fsrc, buffer, sizeof buffer, &br); /* 繧ｳ繝斐�ｼ蜈�縺九ｉ縺九ｉ隱ｭ縺ｿ蜃ｺ縺� */ + if (res || br == 0) break; /* 繧ｨ繝ｩ繝ｼ縺九ヵ繧｡繧､繝ｫ邨らｫｯ */ + res = f_write(&fdst, buffer, br, &bw); /* 縺昴ｌ繧偵さ繝斐�ｼ蜈医↓譖ｸ縺崎ｾｼ繧 */ + if (res || bw < br) break; /* 繧ｨ繝ｩ繝ｼ縺九ョ繧｣繧ｹ繧ｯ貅譚ｯ */ } - /* 全てのファイルを閉じる */ + /* 蜈ｨ縺ｦ縺ｮ繝輔ぃ繧､繝ｫ繧帝哩縺倥ｋ */ f_close(&fsrc); f_close(&fdst); - /* ワーク・エリアを開放する */ + /* 繝ｯ繝ｼ繧ｯ 繧ｨ繝ｪ繧｢繧帝幕謾ｾ縺吶ｋ */ f_mount(NULL, "0:", 0); f_mount(NULL, "1:", 0); @@ -162,10 +162,10 @@ int main (void) - + -- cgit v1.2.3