savelij13
25f499b847
- Fixed f_unlink() may return FR_OK on error. - Fixed wrong cache control in f_lseek(). - Added relative path feature. - Added f_chdir(). - Added f_chdrive(). - Added proper case conversion to extended char.
68 lines
6.1 KiB
HTML
68 lines
6.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
||
<html lang="ja">
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
<meta http-equiv="Content-Style-Type" content="text/css">
|
||
<link rel="up" title="FatFs" href="../00index_j.html">
|
||
<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default">
|
||
<title>FatFs - ファイル・ディレクトリの指定方法</title>
|
||
</head>
|
||
|
||
<body>
|
||
<div class="para">
|
||
<h2>ファイル・ディレクトリの指定方法</h2>
|
||
<p>FatFsモジュールでのファイル、ディレクトリ、ドライブの指定方法はMS-DOSとほぼ同じです。パス名のフォーマットは次の通りです。</p>
|
||
<pre>
|
||
"[<em>論理ドライブ番号</em>:][/]<em>ディレクトリ名</em>/<em>ファイル名</em>"
|
||
</pre>
|
||
<p>FatFsモジュールは長いファイル名および8.3形式ファイル名に対応しています。長いファイル名は、<tt>_USE_LFN == 1</tt>のとき使用可能になります。ディレクトリ・セパレータには / または \ を使用します。論理ドライブ番号は、'0'～'9'の一文字の数字とコロンで指定します。省略した場合は、デフォルト・ドライブ(0またはカレント・ドライブ)が選択されます</p>
|
||
<p>標準構成<tt>(_FS_RPATH == 0)</tt>のときは、全てのオブジェクトがルート・ディレクトリから辿る絶対パスで指定されます。OS指向なカレント・ディレクトリという概念は無く、またドット名("."や"..")は使用できません。パス名先頭のセパレータは無視されます。デフォルト・ドライブ番号は常に0になります。</p>
|
||
<p>相対パスを有効<tt>(_FS_RPATH == 1)</tt>にしたときは、先行するセパレータの有無によって検索開始ディレクトリが変わり、セパレータがある場合はルート・ディレクトリから、無い場合は<a href="chdir.html">f_chdir関数</a>で設定されるカレント・ディレクトリからになります。またパス名の指定にドット名が使用できます。デフォルト・ドライブ番号は<a href="chdrive.html">f_chdrive関数</a>で設定された値となります。</p>
|
||
<table class="lst2">
|
||
<tr><td>パス名</td><td>_FS_RPATH == 0</td><td>_FS_RPATH == 1</td></tr>
|
||
<tr class="lst3"><td>file.txt</td><td>ドライブ0のルート・ディレクトリ下のファイル</td><td>カレント・ドライブのカレント・ディレクトリ下のファイル</td></tr>
|
||
<tr><td>/file.txt</td><td>ドライブ0のルート・ディレクトリ下のファイル</td><td>カレント・ドライブのルート・ディレクトリ下のファイル</td></tr>
|
||
<tr><td></td><td>ドライブ0のルート・ディレクトリ</td><td>カレント・ドライブのカレント・ディレクトリ</td></tr>
|
||
<tr><td>2:</td><td>ドライブ2のルート・ディレクトリ</td><td>ドライブ2のカレント・ディレクトリ</td></tr>
|
||
<tr><td>2:file1.txt</td><td>ドライブ2のルート・ディレクトリ下のファイル</td><td>ドライブ2のカレント・ディレクトリ下のファイル</td></tr>
|
||
<tr><td>2:/</td><td>ドライブ2のルート・ディレクトリ</td><td>ドライブ2のルート・ディレクトリ</td></tr>
|
||
<tr><td>../file.txt</td><td>無効</td><td>親ディレクトリ下のファイル</td></tr>
|
||
<tr><td>.</td><td>無効</td><td>このディレクトリ</td></tr>
|
||
<tr><td>..</td><td>無効</td><td>カレント・ディレクトリの親ディレクトリ</td></tr>
|
||
<tr><td>dir1/..</td><td>無効</td><td>カレント・ディレクトリ</td></tr>
|
||
<tr><td>/..</td><td>無効</td><td>無効(ルート・ディレクトリではドット名は使用不可)</td></tr>
|
||
</table>
|
||
</div>
|
||
|
||
<p><br></p>
|
||
<div class="para">
|
||
<h2>Unicode API</h2>
|
||
<p>ファイル関数の入出力のうちファイル名やパス名を指定する引数の型は、<tt>XCHAR</tt>で定義されていますが、これらは<tt>char</tt>でtypedefされています。そして、<tt>_CODE_PAGE</tt>で指定されるローカル・コード(SBCSまたはDBCS)の文字列として扱われます。ファイル名入出力をUnicodeとする構成(<tt>_USE_LFN != 0</tt>で、かつ<tt>_LFN_UNICODE == 1</tt>)にしたときは、<tt>XCHAR</tt>はワイド文字(<tt>unsigned short</tt>)に切り替わります。これによりLFNフル対応となり、ローカル・コードにない文字(♥☭❶など)も使用できます。</p>
|
||
</div>
|
||
|
||
<p><br></p>
|
||
<div class="para">
|
||
<h2>論理ドライブと物理ドライブの対応</h2>
|
||
<p>標準構成では、それぞれの論理ドライブは同じ番号の物理ドライブに1:1で結びつけられていて、物理ドライブの先頭の区画がマウントされます。<tt>_MULTI_PARTITION == 1</tt>を指定すると、論理ドライブに対して個別に物理ドライブ番号・区画を指定できるようになります。この構成では、論理ドライブと区画の対応を解決するためのテーブルを次に示すように定義する必要があります。</p>
|
||
<pre>
|
||
例:論理ドライブ0～2を物理ドライブ0(固定ディスク)の3つの基本区画に割り当て、
|
||
論理ドライブ3を物理ドライブ1(リムーバブル・ディスク)に割り当てる場合。
|
||
|
||
const PARTITION Drives[] = {
|
||
{0, 0}, /* Logical drive 0 ==> Physical drive 0, 1st partition */
|
||
{0, 1}, /* Logical drive 1 ==> Physical drive 0, 2nd partition */
|
||
{0, 2}, /* Logical drive 2 ==> Physical drive 0, 3rd partition */
|
||
{1, 0} /* Logical drive 3 ==> Physical drive 1 */
|
||
};
|
||
</pre>
|
||
<p>複数区画指定を使用する場合、次の点に注意しなければなりません。
|
||
<ul>
|
||
<li>指定可能な区画は基本区画(0～3)のみ。</li>
|
||
<li>物理ドライブがSFD形式(区画テーブル無し)の場合、区画指定は無視される。</li>
|
||
<li>複数の論理ドライブを持つ物理ドライブは、固定ディスクでなければならない。</li>
|
||
</ul>
|
||
</div>
|
||
|
||
</body>
|
||
</html>
|