1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
4 <meta http-equiv=
"Content-Type" content=
"text/html; charset=utf-8">
5 <meta http-equiv=
"Content-Style-Type" content=
"text/css">
6 <link rel=
"up" title=
"FatFs" href=
"../00index_j.html">
7 <link rel=
"alternate" hreflang=
"en" title=
"English" href=
"../en/filename.html">
8 <link rel=
"stylesheet" href=
"../css_j.css" type=
"text/css" media=
"screen" title=
"ELM Default">
9 <title>FatFs - パス名のフォーマット
</title>
14 <div class=
"para" id=
"nam">
16 <p>FatFsモジュールでのファイル、ディレクトリ、ドライブの指定方法はDOS/Windows APIとほぼ同じです。パス名のフォーマットは次の通りです。
</p>
17 <pre>"[論理ドライブ番号:][/]ディレクトリ名/ファイル名"</pre>
18 <p>FatFsモジュールは長いファイル名(LFN)および
8.3形式ファイル名(SFN)に対応しています。LFNは、(
<tt>_USE_LFN
> 0</tt>)のとき使用可能になります。ディレクトリ・セパレータにはDOS/Windows APIと同じく
<tt>'/'
</tt>と
<tt>'\'
</tt>を使用します。連続したセパレータは無視され
1個として扱われます。唯一の違いは、論理ドライブの指定だけです。論理ドライブ番号は、
<tt>'
0'
</tt>~
<tt>'
9'
</tt>の一文字の数字とコロンで指定し、省略した場合は
<em>デフォルト・ドライブ
</em>(
0またはカレント・ドライブ)が選択されます。
</p>
19 <p>ヌル文字や制御文字(
<tt>'\
0'
</tt>~
<tt>'\x1F'
</tt>)は、パス名の終端として認識されます。パス名に先行あるいは中に含まれるスペースは、LFN構成では名前の一部として有効ですが、非LFN構成ではスペースはパス名の終端として認識されます。
</p>
20 <p>標準構成(
<tt>_FS_RPATH ==
0</tt>)のときは、全てのオブジェクトがルート・ディレクトリから辿る絶対パスで指定されます。OS指向なカレント・ディレクトリという概念は無く、またドット・ディレクトリ(
".
"や
"..
")は使用できません。パス名先頭のセパレータは無視されます。デフォルト・ドライブ番号は常に
0になります。
</p>
21 <p>相対パスを有効(
<tt>_FS_RPATH ==
1</tt>)にしたときは、先行するセパレータの有無によって検索開始ディレクトリが変わり、セパレータがある場合はルート・ディレクトリから、無い場合は
<a href=
"chdir.html"><tt>f_chdir()
</tt></a>で設定されるカレント・ディレクトリからになります。またパス名にドット・ディレクトリが使用できます。デフォルト・ドライブ番号は
<a href=
"chdrive.html"><tt>f_chdrive()
</tt></a>で設定された値となります。
</p>
23 <tr><td>パス名の例
</td><td>_FS_RPATH ==
0</td><td>_FS_RPATH ==
1</td></tr>
24 <tr class=
"lst3"><td>file.txt
</td><td>ドライブ
0のルート・ディレクトリ下のファイル
</td><td>カレント・ドライブのカレント・ディレクトリ下のファイル
</td></tr>
25 <tr><td>/file.txt
</td><td>ドライブ
0のルート・ディレクトリ下のファイル
</td><td>カレント・ドライブのルート・ディレクトリ下のファイル
</td></tr>
26 <tr><td></td><td>ドライブ
0のルート・ディレクトリ
</td><td>カレント・ドライブのカレント・ディレクトリ
</td></tr>
27 <tr><td>2:
</td><td>ドライブ
2のルート・ディレクトリ
</td><td>ドライブ
2のカレント・ディレクトリ
</td></tr>
28 <tr><td>2:file1.txt
</td><td>ドライブ
2のルート・ディレクトリ下のファイル
</td><td>ドライブ
2のカレント・ディレクトリ下のファイル
</td></tr>
29 <tr><td>2:/
</td><td>ドライブ
2のルート・ディレクトリ
</td><td>ドライブ
2のルート・ディレクトリ
</td></tr>
30 <tr><td>../file.txt
</td><td>無効
</td><td>親ディレクトリ下のファイル
</td></tr>
31 <tr><td>.
</td><td>無効
</td><td>このディレクトリ
</td></tr>
32 <tr><td>..
</td><td>無効
</td><td>カレント・ディレクトリの親ディレクトリ
</td></tr>
33 <tr><td>dir1/..
</td><td>無効
</td><td>カレント・ディレクトリ
</td></tr>
34 <tr><td>/..
</td><td>無効
</td><td>ルート・ディレクトリ(その上は辿れない)
</td></tr>
36 <p>また、
<tt>_STR_VOLUME_ID
</tt>オプションを有効にすることでドライブ番号の識別には数字のほか、任意の文字列を使用することも可能になります。
</p>
40 <div class=
"para" id=
"uni">
42 <p>ファイル関数の入出力のうちファイル名やパス名を指定する引数の型は、
<tt>TCHAR
</tt>で定義されていますが、これは通常は
<tt>char
</tt>のエリアスになっています。そして、
<tt>_CODE_PAGE
</tt>で指定されるANSI/OEMコード(SBCSまたはDBCS)の文字列として扱われます。ファイル名入出力をUnicodeとする構成(
<tt>_LFN_UNICODE ==
1</tt>)にしたときは、
<tt>TCHAR
</tt>はワイド文字(
<tt>WCHAR, unsigned short
</tt>)に切り替わり、パス名の入出力にUnicodeを使用するようになります。これによりLFN規格に完全対応となり、ANSI/OEMコードにない文字(たとえば ✝☪✡☸☭など)も使用できます。この設定は文字列入出力関数のデータ型とファイル上のエンコーディングにも影響を与えます。リテラル文字列を定義するとき、次に示すように
<tt>_T(s)
</tt>および
<tt>_TEXT(s)
</tt>マクロを使ってANSI/OEMとUnicodeを自動切り替えすることができます。
</p>
44 f_open(fp,
"filename.txt", FA_READ);
<span class=
"c">/* ANSI/OEM専用コード */
</span>
45 f_open(fp, L
"filename.txt", FA_READ);
<span class=
"c">/* Unicode専用コード */
</span>
46 f_open(fp, _T(
"filename.txt"), FA_READ);
<span class=
"c">/* 両用コード(自動切り替え) */
</span>
51 <div class=
"para" id=
"vol">
53 <p>デフォルトの構成では、それぞれの論理ドライブは同じ番号の物理ドライブに
1:
1で結びつけられていて、自動検出機能によりその物理ドライブ上の一つのFATボリュームがマウントされます。FATボリュームの検出は、セクタ
0、第一区画~第四区画の順に行われます。
</p>
54 <p><tt>_MULTI_PARTITION
</tt>に
1を指定すると、それぞれの論理ドライブに対して個別に物理ドライブ番号と区画を指定できるようになります。この構成では、論理ドライブと区画の対応を解決するためのテーブルを次に示すように定義する必要があります。
</p>
56 例:論理ドライブ
0~
2を物理ドライブ
0(非リムーバブル)の
3つの基本区画に割り当て、
57 論理ドライブ
3を物理ドライブ
1(リムーバブル)に割り当てる場合。
59 PARTITION VolToPart[] = {
60 {
0,
1},
<span class=
"c">/* 論理ドライブ
0 ==
> 物理ドライブ
0, 第
1区画 */
</span>
61 {
0,
2},
<span class=
"c">/* 論理ドライブ
1 ==
> 物理ドライブ
0, 第
2区画 */
</span>
62 {
0,
3},
<span class=
"c">/* 論理ドライブ
2 ==
> 物理ドライブ
0, 第
3区画 */
</span>
63 {
1,
0}
<span class=
"c">/* 論理ドライブ
3 ==
> 物理ドライブ
1, 自動検出 */
</span>
66 <img src=
"../img/f7.png" width=
"828" height=
"288" alt=
"論理ドライブと物理ドライブの関係">
68 <p>複数区画指定を使用する場合、次の点に注意しなければなりません。
70 <li>マウント可能な区画は基本区画のみで、拡張区画内には対応しない。
</li>
71 <li>複数のマウントされた区画を持つ物理ドライブは、非リムーバブルでなければならず、システム動作中のメディア交換は禁止。
</li>