From 5366852335044c1e68a5c32548d3051cc943552f Mon Sep 17 00:00:00 2001 From: Leo C Date: Tue, 19 Aug 2014 15:31:33 +0200 Subject: Import fatfs R0.10b FatFs Module Source Files R0.10b Author: (C)ChaN, 2014 (http://elm-chan.org) URL: http://elm-chan.org/fsw/ff/ff10b.zip --- fatfs/doc/ja/open.html | 171 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 171 insertions(+) create mode 100644 fatfs/doc/ja/open.html (limited to 'fatfs/doc/ja/open.html') diff --git a/fatfs/doc/ja/open.html b/fatfs/doc/ja/open.html new file mode 100644 index 0000000..a4c4a18 --- /dev/null +++ b/fatfs/doc/ja/open.html @@ -0,0 +1,171 @@ + + +
+ + + + + +ファイルをオープンまたは作成します。
++FRESULT f_open ( + 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にしてから開きます。 |
+FR_OK, +FR_DISK_ERR, +FR_INT_ERR, +FR_NOT_READY, +FR_NO_FILE, +FR_NO_PATH, +FR_INVALID_NAME, +FR_DENIED, +FR_EXIST, +FR_INVALID_OBJECT, +FR_WRITE_PROTECTED, +FR_INVALID_DRIVE, +FR_NOT_ENABLED, +FR_NO_FILESYSTEM, +FR_TIMEOUT, +FR_LOCKED, +FR_NOT_ENOUGH_CORE, +FR_TOO_MANY_OPEN_FILES +
+既存のファイルを開いたり、新しいファイルを作成します。関数が成功するとファイル・オブジェクトが作成され、以降そのファイルに対するアクセスに使用します。ファイルを閉じるときは、f_close()を使用します。何らかの変更が行われたファイルがその後正しく閉じられなかった場合、そのファイルが破損する場合があります。
+既に開かれているファイルを開く必要がある場合は、多重アクセス制御を参照してください。しかし、一つのファイルに対する書き込みモードを含む重複オープンは常に禁止です。
+ファイル・アクセスを開始する前に、f_mount()を使ってそれぞれの論理ドライブにワーク・エリア(ファイル・システム・オブジェクト)を与える必要があります。この初期化の後、その論理ドライブに対して全てのファイル関数が使えるようになります。
+全ての構成で使用可能です。_FS_READONLY == 1のときは、FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYSの各フラグはサポートされません。
++/* テキストファイルを読み出して表示 */ + +FATFS FatFs; /* 論理ドライブのワーク・エリア(ファイル・システム・オブジェクト) */ + +int main (void) +{ + 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行ずつ読み出して表示 */ + while (f_gets(line, sizeof line, &fil)) + printf(line); + + /* ファイルを閉じる */ + f_close(&fil); + + return 0; +} ++
+/* ドライブ1のファイル "file.bin" をドライブ0へコピー */ + +int main (void) +{ + 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にワーク・エリアを与える */ + f_mount(&fs[0], "0:", 0); + f_mount(&fs[1], "1:", 0); + + /* ドライブ1のコピー元ファイルを開く */ + res = f_open(&fsrc, "1:file.dat", FA_OPEN_EXISTING | FA_READ); + if (fr) return (int)fr; + + /* ドライブ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; /* エラーかディスク満杯 */ + } + + /* 全てのファイルを閉じる */ + f_close(&fsrc); + f_close(&fdst); + + /* ワーク・エリアを開放する */ + f_mount(NULL, "0:", 0); + f_mount(NULL, "1:", 0); + + return (int)fr; +} ++