diff options
Diffstat (limited to 'fatfs/doc/ja')
47 files changed, 1002 insertions, 924 deletions
diff --git a/fatfs/doc/ja/appnote.html b/fatfs/doc/ja/appnote.html index 0fb5579..4985bae 100644 --- a/fatfs/doc/ja/appnote.html +++ b/fatfs/doc/ja/appnote.html @@ -6,24 +6,24 @@ <link rel="up" title="FatFs" href="../00index_j.html">
<link rel="alternate" hreflang="en" title="English" href="../en/appnote.html">
<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default">
-<title>FatFsモジュール アプリケーション・ノート</title>
+<title>FatFsモジュール アプリケーション ノート</title>
</head>
<body>
-<h1>FatFsモジュール アプリケーション・ノート</h1>
+<h1>FatFsモジュール アプリケーション ノート</h1>
<ol class="toc">
<li><a href="#port">ポーティングの際に配慮すべきこと</a></li>
<li><a href="#limits">限界値</a></li>
<li><a href="#memory">メモリ使用量</a></li>
-<li><a href="#reduce">モジュール・サイズの縮小</a></li>
+<li><a href="#reduce">モジュール サイズの縮小</a></li>
<li><a href="#lfn">長いファイル名</a></li>
<li><a href="#jap">日本語ファイル名の大文字変換</a></li>
<li><a href="#unicode">Unicode入出力への対応</a></li>
<li><a href="#reentrant">リエントランシー</a></li>
-<li><a href="#dup">多重ファイル・アクセス</a></li>
-<li><a href="#fs1">効率的なファイル・アクセス</a></li>
-<li><a href="#fs2">フラッシュ・メモリの特性への配慮</a></li>
-<li><a href="#critical">クリチカル・セクション</a></li>
+<li><a href="#dup">多重ファイル アクセス</a></li>
+<li><a href="#fs1">効率的なファイル アクセス</a></li>
+<li><a href="#fs2">フラッシュ メモリの特性への配慮</a></li>
+<li><a href="#critical">クリチカル セクション</a></li>
<li><a href="#fs3">APIの拡張的使用例</a></li>
<li><a href="#license">FatFsのライセンスについて</a></li>
</ol>
@@ -44,18 +44,18 @@ FatFsモジュールはANSI C(C89)準拠で記述されているので、普通 <h4>システム構成</h4>
<p>下に示す依存関係図は、FatFsモジュール利用の組み込みシステムにおける代表的な構成を示します。</p>
<p><img src="../img/modules.png" width="580" height="280" alt="システム構成図"></p>
-<p>(a) FatFs用に書かれたディスク・モジュールがある場合は、そのまま追加するだけです。 (b) しかし、多くの既存のディスク・モジュールはそのAPIをFatFsに合わせるため、グルー関数が必要になるでしょう。</p>
+<p>(a) FatFs用に書かれたディスク モジュールがある場合は、そのまま追加するだけです。 (b) しかし、多くの既存のディスク モジュールはそのAPIをFatFsに合わせるため、グルー関数が必要になるでしょう。</p>
<p><img src="../img/funcs.png" width="680" height="430" alt="functional diagram"></p>
<h4>ユーザの作成する関数</h4>
-<p>必要なのはFatFsモジュールの要求するディスク関数を用意することだけで、それ以外にすることはありません。既に動作しているディスク・モジュールがあるなら、そのAPIをFatFsに合わせるかグルー関数を介してつなぐだけで済みますが、無い場合はほかから移植するか最初から書くかする必要があります。定義されている全ての関数が常に必要なわけではありません。例えば、リード・オンリー構成では書き込み系関数は必要ありません。次の表に構成オプションと要求される関数の対応を示します。</p>
+<p>必要なのはFatFsモジュールの要求するディスク関数を用意することだけで、それ以外にすることはありません。既に動作しているディスク モジュールがあるなら、そのAPIをFatFsに合わせるかグルー関数を介してつなぐだけで済みますが、無い場合はほかから移植するか最初から書くかする必要があります。定義されている全ての関数が常に必要なわけではありません。例えば、リード オンリー構成では書き込み系関数は必要ありません。次の表に構成オプションと要求される関数の対応を示します。</p>
<table class="lst2">
<tr><th>必要な関数</th><th>必要となる条件</th><th>備考</th></tr>
<tr><td>disk_status<br>disk_initialize<br>disk_read</td><td>常時</td><td rowspan="5">ffsample.zip (サンプル)<br>その他web上に多数</td></tr>
<tr><td>disk_write<br>get_fattime<br>disk_ioctl (CTRL_SYNC)</td><td>_FS_READONLY == 0</td></tr>
<tr><td>disk_ioctl (GET_SECTOR_COUNT)<br>disk_ioctl (GET_BLOCK_SIZE)</td><td>_USE_MKFS == 1</td></tr>
<tr><td>disk_ioctl (GET_SECTOR_SIZE)</td><td>_MAX_SS != _MIN_SS</td></tr>
-<tr><td>disk_ioctl (CTRL_ERASE_SECTOR)</td><td>_USE_ERASE == 1</td></tr>
+<tr><td>disk_ioctl (CTRL_TRIM)</td><td>_USE_TRIM == 1</td></tr>
<tr><td>ff_convert<br>ff_wtoupper</td><td>_USE_LFN >= 1</td><td>option/unicode.c</td></tr>
<tr><td>ff_cre_syncobj<br>ff_rel_grant<br>ff_req_grant<br>ff_del_syncobj</td><td>_FS_REENTRANT == 1</td><td rowspan="2">option/syscall.c (サンプル)</td></tr>
<tr><td>ff_mem_alloc<br>ff_mem_free</td><td>_USE_LFN == 3</td></tr>
@@ -66,18 +66,18 @@ FatFsモジュールはANSI C(C89)準拠で記述されているので、普通 <h3>限界値</h3>
<ul>
<li>FATタイプ: FAT12, FAT16, FAT32。</li>
-<li>同時オープン・ファイル数: 無制限。(利用可能メモリによる)</li>
+<li>同時オープン ファイル数: 無制限。(利用可能メモリによる)</li>
<li>ボリューム数: 最大 10。</li>
-<li>ファイル・サイズ: FAT規格に依存。(最大 4G-1バイト)</li>
-<li>ボリューム・サイズ: FAT規格に依存。(最大 2Tバイト(512バイト/セクタ時))</li>
-<li>クラスタ・サイズ: FAT規格に依存。(最大 64Kバイト(512バイト/セクタ時))</li>
-<li>セクタ・サイズ: FAT規格に依存。(512～4096バイト)</li>
+<li>ファイル サイズ: FAT規格に依存。(最大 4G-1バイト)</li>
+<li>ボリューム サイズ: FAT規格に依存。(最大 2Tバイト(512バイト/セクタ時))</li>
+<li>クラスタ サイズ: FAT規格に依存。(最大 64Kバイト(512バイト/セクタ時))</li>
+<li>セクタ サイズ: FAT規格に依存。(512～4096バイト)</li>
</ul>
</div>
<div class="para" id="memory">
<h3>メモリ使用量</h3>
-<p>次の表にいくつかのターゲットにおけるメモリ使用量の例を示します。テスト時の構成オプションはその下の通りです。数値の単位はバイトで、<em>V</em>はボリューム数、<em>F</em>は同時オープン・ファイル数を示します。コンパイラの最適化オプションはコード・サイズとしています。</p>
+<p>次の表にいくつかのターゲットにおけるメモリ使用量の例を示します。テスト時の構成オプションはその下の通りです。数値の単位はバイトで、<em>V</em>はボリューム数、<em>F</em>は同時オープン ファイル数を示します。コンパイラの最適化オプションはコード サイズとしています。</p>
<table class="lst2">
<tr><th></th><th>ARM7<small><br>32bit</small></th><th>ARM7<small><br>Thumb</small></th><th>CM3<small><br>Thumb-2</small></th><th>AVR</th><th>H8/300H</th><th>PIC24</th><th>RL78</th><th>V850ES</th><th>SH-2A</th><th>RX600</th><th>IA-32</th></tr>
<tr class="cal"> <td>Compiler</td><td>GCC</td><td>GCC</td><td>GCC</td><td>GCC</td><td>CH38</td><td>C30</td><td>CC78K0R</td><td>CA850</td><td>SHC</td><td>RXC</td><td>VC6</td></tr>
@@ -99,7 +99,7 @@ _USE_STRFUNC 0 (Disable string functions) _USE_MKFS 0 (Disable f_mkfs function)
_USE_FORWARD 0 (Disable f_forward function)
_USE_FASTSEEK 0 (Disable fast seek feature)
-_CODE_PAGE 932 (Japanese Shift-JIS)
+_CODE_PAGE 932 (Japanese Shift_JIS)
_USE_LFN 0 (Disable LFN feature)
_MAX_SS 512 (Fixed sector size)
_FS_RPATH 0 (Disable relative path feature)
@@ -112,7 +112,7 @@ _FS_LOCK 0 (Disable file lock control) </div>
<div class="para" id="reduce">
-<h3>モジュール・サイズの縮小</h3>
+<h3>モジュール サイズの縮小</h3>
<p>次の表は構成オプションの設定値によりどの機能が削除されるかを示します。</p>
<table class="lst2">
<tr><td rowspan="2">Function</td><td colspan="4">_FS_MINIMIZE</td><td colspan="2">_FS_READONLY</td><td colspan="2">_USE_STRFUNC</td><td colspan="3">_FS_RPATH</td><td colspan="2">_FS_LABEL</td><td colspan="2">_USE_MKFS</td><td colspan="2">_USE_FORWARD</td><td colspan="2">_MULTI_PARTITION</td></tr>
@@ -152,19 +152,19 @@ _FS_LOCK 0 (Disable file lock control) <div class="para" id="lfn">
<h3>長いファイル名</h3>
-<p>FatFsモジュールは、長いファイル名(LFN)をサポートします。ファイルに付けられた2つの異なる名前(短いファル名と長いファイル名)は、<tt>f_readdir()</tt>を除くファイル操作関数において透過です。デフォルト構成では、LFN機能はOFFになっています。LFN機能を有効にするには、<tt>_USE_LFN</tt>を1,2または3に設定し、<tt>option/unicode.c</tt>をプロジェクトに追加します。LFN機能は、加えてある程度のワーク・エリア(LFN操作バッファ)を必要とします。バッファ長は使用できるメモリに応じて<tt>_MAX_LFN</tt>オプションで構成されることができます。LFNの長さは最大255文字に達するので、LFN完全対応のためには<tt>_MAX_LFN</tt>は255に設定されるべきです。与えられたファイル名に対してバッファ長が不足した場合、ファイル関数は<tt>FR_INVALID_NAME</tt>で失敗します。</p>
-<p>ファイル関数に再入を行う条件の下でLFN機能を使用する場合は、<tt>_USE_LFN</tt>は2または3に設定されなければなりません。この場合、ファイル関数はワーク・エリアを動的に確保(スタックまたはヒープ)します。バッファ・サイズは、<tt>(_MAX_LFN + 1) * 2</tt>バイトになるので、スタック等のサイズはそれを考慮した十分なサイズでなければなりません。</p>
+<p>FatFsモジュールは、長いファイル名(LFN)をサポートします。ファイルに付けられた2つの異なる名前(短いファル名と長いファイル名)は、<tt>f_readdir()</tt>を除くファイル操作関数において透過です。デフォルト構成では、LFN機能はOFFになっています。LFN機能を有効にするには、<tt>_USE_LFN</tt>を1,2または3に設定し、<tt>option/unicode.c</tt>をプロジェクトに追加します。LFN機能は、加えてある程度のワーク エリア(LFN操作バッファ)を必要とします。バッファ長は使用できるメモリに応じて<tt>_MAX_LFN</tt>オプションで構成されることができます。LFNの長さは最大255文字に達するので、LFN完全対応のためには<tt>_MAX_LFN</tt>は255に設定されるべきです。与えられたファイル名に対してバッファ長が不足した場合、ファイル関数は<tt>FR_INVALID_NAME</tt>で失敗します。</p>
+<p>ファイル関数に再入を行う条件の下でLFN機能を使用する場合は、<tt>_USE_LFN</tt>は2または3に設定されなければなりません。この場合、ファイル関数はワーク エリアを動的に確保(スタックまたはヒープ)します。バッファ サイズは、<tt>(_MAX_LFN + 1) * 2</tt>バイトになるので、スタック等のサイズはそれを考慮した十分なサイズでなければなりません。</p>
<table class="lst2 rset">
<caption>LFN cfg on ARM7</caption>
<tr><th>コードページ</th><th>コードサイズ[bytes]</th></tr>
<tr><td>SBCS</td><td>+3721</td></tr>
-<tr><td>932(Shift-JIS)</td><td>+62609</td></tr>
+<tr><td>932(Shift_JIS)</td><td>+62609</td></tr>
<tr><td>936(GBK)</td><td>+177797</td></tr>
<tr><td>949(Korean)</td><td>+139857</td></tr>
<tr><td>950(Big5)</td><td>+111497</td></tr>
</table>
-<p>LFN機能の上手な使い方は、それを使わないということです。実際、組み込み用途ではLFN機能がどうしても必要になるということはほとんど無いはずです。LFNを有効にすると、選択されたコード・ページに応じてモジュール・サイズが増大されます。右の表に各コード・ページにおけるLFNを有効にしたときのモジュール・サイズの違いを示します。特に、CJK地域では数万の文字が使われていますが、不幸なことにそれは巨大なOEM－Unicode相互変換テーブルを要求し、モジュール・サイズは劇的に増大されます。その結果、それらのコード・ページにおいてLFNを有効にしたFatFsモジュールは、AVRを含む殆どの8ビット・マイコンにインプリメントされることができません。</p>
-<p>LFN機能のハードルはそれだけではありません。マイクロソフト社はFATファイル・システムについていくつかの特許を保有しています。いずれもLFN機能の実装に関するもので、その利用に対して$0.25/unitのライセンス料を要求しています。このため、商用製品でLFN機能を利用するときは、最終仕向地によってはライセンスが必要になります。最近のFAT32ドライバの多くはLFN機能を含んでいるため、それらの使用に当たってライセンスが必要になりますが、FatFsではLFN機能を構成オプションで任意にON/OFFできるため、無効にしてライセンス問題を回避することもできます。</p>
+<p>LFN機能の上手な使い方は、それを使わないということです。実際、組み込み用途ではLFN機能がどうしても必要になるということはほとんど無いはずです。LFNを有効にすると、選択されたコード ページに応じてモジュール サイズが増大します。右の表に各コード ページにおけるLFNを有効にしたときのモジュール サイズの違いを示します。特に、CJK地域では数万の文字が使われていますが、不幸なことにそれは巨大なOEM－Unicode相互変換テーブルを要求し、モジュール サイズは劇的に増大します。その結果、それらのコード ページにおいてLFNを有効にしたFatFsモジュールは、多くの8ビット マイコンにインプリメントすることができません。</p>
+<p>LFN機能のハードルはそれだけではありません。マイクロソフト社はFATファイル システムについていくつかの特許を保有しています。いずれもLFN機能の実装に関するもので、その利用に対して$0.25/unitのライセンス料を要求しています。このため、商用製品でLFN機能を利用するときは、最終仕向地によってはライセンスが必要になります。最近のFAT32ドライバの多くはLFN機能を含んでいるため、それらの使用に当たってライセンスが必要になりますが、FatFsではLFN機能を構成オプションで任意にON/OFFできるため、無効にしてライセンス問題を回避することもできます。</p>
</div>
<div class="para" id="jap">
@@ -179,61 +179,61 @@ _FS_LOCK 0 (Disable file lock control) <div class="para" id="reentrant">
<h3>リエントランシー</h3>
-<p>互いに異なるボリュームに対するファイル操作はリエントラントで、常に同時平行に動作できます。同じボリュームに対してはデフォルトではリエントラントではありませんが、<tt>_FS_REENTRANT</tt>オプションでリエントラント(スレッド・セーフ)にすることはできます。この場合、OS依存の同期オブジェクト操作関数<tt>ff_cre_syncobj(), ff_del_syncobj(), ff_req_grant(), ff_rel_grant()</tt>もまたプロジェクトに追加されなければなりません。サンプル・コードと解説は<tt>option/syncobj.c</tt>にあります。</p>
+<p>互いに異なるボリュームに対するファイル操作はリエントラントで、常に同時平行に動作できます。同じボリュームに対してはデフォルトではリエントラントではありませんが、<tt>_FS_REENTRANT</tt>オプションでリエントラント(スレッド セーフ)にすることはできます。この場合、OS依存の同期オブジェクト操作関数<tt>ff_cre_syncobj(), ff_del_syncobj(), ff_req_grant(), ff_rel_grant()</tt>もまたプロジェクトに追加されなければなりません。サンプル コードと解説は<tt>option/syncobj.c</tt>にあります。</p>
<p>この場合、あるタスクがボリュームを使用中に他のタスクからそのボリュームに対するファイル関数が呼び出されると、そのアクセスは先のタスクがファイル関数を抜けるまでブロックされます。もし、待ち時間が<tt>_TIMEOUT</tt>で指定された期間を越すと、その関数は<tt>FR_TIMEOUT</tt>でアボートします。いくつかのRTOSではタイムアウト機能はサポートされないかも知れません。</p>
-<p>ひとつの例外が<tt>f_mount(), f_mkfs(), f_fdisk()</tt>にあります。これらの関数は同じボリューム(または関連する物理ドライブ)に対してリエントラントではありません。これらの関数を使用するときは、アプリケーション・レベルで排他制御しなければなりません。</p>
+<p>ひとつの例外が<tt>f_mount(), f_mkfs(), f_fdisk()</tt>にあります。これらの関数は同じボリューム(または関連する物理ドライブ)に対してリエントラントではありません。これらの関数を使用するときは、アプリケーション レベルで排他制御しなければなりません。</p>
<p>注: このセクションはFatFsモジュールそれ自体のリエントランシーについて説明しています。その下位のディスクI/Oモジュールのリエントランシーに関しては何の前提もありません。</p>
</div>
<div class="para" id="dup">
-<h3>多重ファイル・アクセス</h3>
-<p>FatFsモジュールではデフォルトでは多重アクセス制御機能をサポートしていません。ファイルに対する多重アクセスは、そのアクセス・モードによって制限されます。一つのファイルに対する多重オープンは、それらが全てリード・モードのときに限って許可されます。書き込みモードを含む多重オープン、また開かれているファイルに対するリネームや削除を行ってはなりません。さもないと、そのボリュームのFAT構造が破壊される可能性があります。</p>
-<p><tt>_FS_LOCK</tt>に1以上の値(値は同時に管理できるファイル数)をセットすることで多重アクセス制御機能が有効になり、ファイル単位のアクセス制御を自動で行うこともできます。この場合、上記のルールを破ったオープン・リネーム・削除を試みると、その関数は<tt>FR_LOCKED</tt>で失敗します。また、<tt>_FS_LOCK</tt>を越える数のファイルやサブ・ディレクトリを同時にオープンしようとすると、<tt>FR_TOO_MANY_OPEN_FILES</tt>で失敗します。</p>
+<h3>多重ファイル アクセス</h3>
+<p>FatFsモジュールではデフォルトでは多重アクセス制御機能をサポートしていません。ファイルに対する多重アクセスは、そのアクセス モードによって制限されます。一つのファイルに対する多重オープンは、それらが全てリード モードのときに限って許可されます。書き込みモードを含む多重オープン、また開かれているファイルに対するリネームや削除を行ってはなりません。さもないと、そのボリュームのFAT構造が破壊される可能性があります。</p>
+<p><tt>_FS_LOCK</tt>に1以上の値(値は同時に管理できるファイル数)をセットすることで多重アクセス制御機能が有効になり、ファイル単位のアクセス制御を自動で行うこともできます。この場合、上記のルールを破ったオープン・リネーム・削除を試みると、その関数は<tt>FR_LOCKED</tt>で失敗します。また、<tt>_FS_LOCK</tt>を越える数のファイルやサブ ディレクトリを同時にオープンしようとすると、<tt>FR_TOO_MANY_OPEN_FILES</tt>で失敗します。</p>
</div>
<div class="para" id="fs1">
-<h3>効率的なファイル・アクセス</h3>
-<p>小規模な組込システムでのファイルの読み書きにおける効率の良いアクセスのため、アプリケーション・プログラマはFatFsモジュールの中でどのような処理が行われているか考慮すべきです。ストレージ上のデータは<tt>f_read()</tt>により次のシーケンスで転送されます。</p>
-<p>図1. セクタ・ミスアラインド・リード (ショート)<br>
+<h3>効率的なファイル アクセス</h3>
+<p>小規模な組込システムでのファイルの読み書きにおける効率の良いアクセスのため、アプリケーション プログラマはFatFsモジュールの中でどのような処理が行われているか考慮すべきです。ストレージ上のデータは<tt>f_read()</tt>により次のシーケンスで転送されます。</p>
+<p>図1. セクタ ミスアラインド リード (ショート)<br>
<img src="../img/f1.png" width="490" height="110" alt="fig.1">
</p>
-<p>図2. セクタ・ミスアラインド・リード (ロング)<br>
+<p>図2. セクタ ミスアラインド リード (ロング)<br>
<img src="../img/f2.png" width="490" height="140" alt="fig.2">
</p>
-<p>図3. セクタ・アラインド・リード<br>
+<p>図3. セクタ アラインド リード<br>
<img src="../img/f3.png" width="490" height="119" alt="fig.3">
</p>
-<p>ファイルI/Oバッファはセクタの一部のデータを読み書きするためのセクタ・バッファを意味します。セクタ・バッファは、それぞれのファイル・オブジェクト内のプライベート・セクタ・バッファまたはファイル・システム・オブジェクト内の共有セクタ・バッファのどちらかです。バッファ構成オプションの<tt>_FS_TINY</tt>は、データ転送にどちらを使うかを決定します。タイニー・バッファ(1)が選択されるとデータ・メモリの消費はそれぞれのファイル・オブジェクトで512バイト減少されます。この場合、FatFsモジュールはファイル・データの転送とFAT/ディレクトリ・アクセスにファイル・システム・オブジェクト内のセクタ・バッファだけを使用します。タイニー・バッファの欠点は、セクタ・バッファにキャッシュされたFATデータがファイル・データの転送により失われ、クラスタ境界の毎にリロードされなければならないことです。でも、悪くない性能と少ないメモリ消費の視点から多くのアプリケーションに適するでしょう。</p>
-<p>図1はセクタの一部のデータがファイルI/Oバッファを経由で転送されることを示します。図2に示される長いデータの転送では、転送データの中間の1セクタまたはそれ以上のセクタにまたがる転送データがアプリケーション・バッファに直接転送されています。図3は転送データ全体がセクタ境界にアライメントされている場合を示しています。この場合、ファイルI/Oバッファは使用されません。直接転送においては最大の範囲のセクタが<tt>disk_read()</tt>で一度に読み込まれますが、クラスタ境界を越えるマルチ・セクタ転送はそれが隣接であっても行われません。</p>
-<p>このように、セクタにアライメントしたファイルの読み書きへの配慮はバッファ経由のデータ転送を避け、読み書き性能は改善されるでしょう。その効果に加え、タイニー構成でキャッシュされたFATデータがファイル・データの転送によりフラッシュされず、非タイニー構成と同じ性能を小さなメモリ・フットプリントで達成できます。</p>
+<p>ファイルI/Oバッファはセクタの一部のデータを読み書きするためのセクタ バッファを意味します。セクタ バッファは、それぞれのファイル オブジェクト内のプライベート セクタ バッファまたはファイル システム オブジェクト内の共有セクタ バッファのどちらかです。バッファ構成オプションの<tt>_FS_TINY</tt>は、データ転送にどちらを使うかを決定します。タイニー バッファ(1)が選択されるとデータ メモリの消費はそれぞれのファイル オブジェクトで<tt>_MAX_SS</tt>バイト減少されます。この場合、FatFsモジュールはファイル データの転送とFAT/ディレクトリ アクセスにファイル システム オブジェクト内のセクタ バッファだけを使用します。タイニー バッファの欠点は、セクタ バッファにキャッシュされたFATデータがファイル データの転送により失われ、クラスタ境界の毎にリロードされなければならないことです。でも、悪くない性能と少ないメモリ消費の視点から多くのアプリケーションに適するでしょう。</p>
+<p>図1はセクタの一部のデータがファイルI/Oバッファを経由で転送されることを示します。図2に示される長いデータの転送では、転送データの中間の1セクタまたはそれ以上のセクタにまたがる転送データがアプリケーション バッファに直接転送されています。図3は転送データ全体がセクタ境界にアライメントされている場合を示しています。この場合、ファイルI/Oバッファは使用されません。直接転送においては最大の範囲のセクタが<tt>disk_read()</tt>で一度に読み込まれますが、クラスタ境界を越えるマルチ セクタ転送はそれが隣接であっても行われません。</p>
+<p>このように、セクタにアライメントしたファイルの読み書きへの配慮はバッファ経由のデータ転送を避け、読み書き性能は改善されるでしょう。その効果に加え、タイニー構成でキャッシュされたFATデータがファイル データの転送によりフラッシュされず、非タイニー構成と同じ性能を小さなメモリ フットプリントで達成できます。</p>
</div>
<div class="para" id="fs2">
-<h3>フラッシュ・メモリの特性への配慮</h3>
-<p>HDDなどのディスク・メディアとは異なり、SDCやCFCなどのフラッシュ・メモリ・メディアの性能を引き出すには、その特性を意識した制御が必要になります。</p>
-<h4>マルチ・セクタ書き込み</h4>
+<h3>フラッシュ メモリの特性への配慮</h3>
+<p>HDDなどのディスク メディアとは異なり、SDCやCFCなどのフラッシュ メモリ メディアの性能を引き出すには、その特性を意識した制御が必要になります。</p>
+<h4>マルチ セクタ書き込み</h4>
<div class="rset">
-図6. マルチ/シングル・セクタ・ライトの比較<br>
+図6. マルチ/シングル セクタ ライトの比較<br>
<img src="../img/f6.png" width="630" height="148" alt="fig.6">
</div>
-<p>フラッシュ・メモリ・メディアの書き込み速度はシングル・セクタ書き込みの時に最も低いものになり、一回のトランザクションで転送されるセクタ数が大きくなるほど書き込み速度は向上します。この効果はバス速度が高速になるほど顕著で、10倍以上の差が現れることも珍しくありません。<a href="../img/rwtest2.png">テスト結果</a>は、マルチ・セクタ書き込み(W:16K, 32 sectors)がシングル・セクタ書き込み(W:100, 1 sector)よりどの程度速いかを明確に示しています。大容量メディアほどシングル・セクタ書き込みが遅くなる点もまた重要です。書き込みトランザクションの回数はまた、メディアの寿命にも影響してきます。このため、アプリケーションはなるべく大きなブロック(クラスタ・サイズまたは2の累乗セクタ境界にアライメントした)で読み書きを行う必要があります。もちろん、アプリケーションからメディアに至る全てのレイヤがマルチ・セクタ転送に対応していないと意味がありません。残念ながら、既存のオープン・ソースのドライバの多くはマルチ・セクタ転送に未対応です。なお、FatFsモジュールおよびサンプル・ドライバはマルチ・セクタ転送に対応しています。</p>
+<p>フラッシュ メモリ メディアの書き込み速度はシングル セクタ書き込みの時に最も低いものになり、一回のトランザクションで転送されるセクタ数が大きくなるほど書き込み速度は向上します。この効果はバス速度が高速になるほど顕著で、10倍以上の差が現れることも珍しくありません。<a href="../img/rwtest2.png">テスト結果</a>は、マルチ セクタ書き込み(W:16K, 32 sectors)がシングル セクタ書き込み(W:100, 1 sector)よりどの程度速いかを明確に示しています。大容量メディアほどシングル セクタ書き込みが遅くなる点もまた重要です。書き込みトランザクションの回数はまた、メディアの寿命にも影響してきます。このため、アプリケーションはなるべく大きなブロック(クラスタ サイズまたは2の累乗セクタ境界にアライメントした)で読み書きを行う必要があります。もちろん、アプリケーションからメディアに至る全てのレイヤがマルチ セクタ転送に対応していないと意味がありません。残念ながら、既存のオープン ソースのドライバの多くはマルチ セクタ転送に未対応です。なお、FatFsモジュールおよびサンプル ドライバはマルチ セクタ転送に対応しています。</p>
<h4>明示的なメモリ消去</h4>
-<p>通常のファイル消去では、記録されたデータに対して何らかの制御が行われるわけではなく、単にFAT上に未使用クラスタとして記録されているだけです。このため、ファイルが消去されたあともそれらは有効なメモリ・ブロックとしてフラッシュ・メモリ上に残ります。そこで、ファイルを消去するとき、占有していたデータ・セクタを明示的に消去(つまり未使用ブロックにする)することにより、メディア内の空きブロックを増やすことができます。これにより、次にそのブロックに書き込むときの消去動作が無くなり、書き込み性能が向上する可能性があります。また、ウェアレベリングに使えるブロックが増え、メディアの耐久性も向上するかも知れません。この機能を有効にするには、構成オプションの<tt>_USE_ERASE</tt>に1を設定します。これはフラッシュ・メモリ・メディアの内部動作に期待した制御なので、効果があるとは限りません。また、ファイル消去の時間が延びることも考慮に入れるべきです。</p>
+<p>通常のファイル消去では、記録されたデータに対して何らかの制御が行われるわけではなく、単にFAT上に未使用クラスタとして記録されているだけです。このため、ファイルが消去されたあともそれらは有効なメモリ ブロックとしてフラッシュ メモリ上に残ります。そこで、ファイルを消去するとき、占有していたデータ セクタを明示的に消去(つまり未使用ブロックにする)することにより、メディア内の空きブロックを増やすことができます。これにより、次にそのブロックに書き込むときの消去動作が無くなり、書き込み性能が向上する可能性があります。また、ウェアレベリングに使えるブロックが増え、メディアの耐久性も向上するかも知れません。この機能を有効にするには、構成オプションの<tt>_USE_TRIM</tt>に1を設定します。これはフラッシュ メモリ メディアの内部動作に期待した制御なので、効果があるとは限りません。また、ファイル消去の時間が延びることも考慮に入れるべきです。</p>
</div>
<div class="para" id="critical">
-<h3>クリチカル・セクション</h3>
-<p>ストレージ上のFAT構造を操作している途中で、停電、不正なメディアの取り外し、回復不能なデータ・エラー等の障害が発生すると、処理が中途半端な状態で中断され、その結果としてFATボリュームの構造が破壊される可能性があります。次にFatFsモジュールにおけるクリチカル・セクションと、その間の障害により起きうるエラーの状態を示します。</p>
+<h3>クリチカル セクション</h3>
+<p>ストレージ上のFAT構造を操作している途中で、停電、不正なメディアの取り外し、回復不能なデータ エラー等の障害が発生すると、処理が中途半端な状態で中断され、その結果としてFATボリュームの構造が破壊される可能性があります。次にFatFsモジュールにおけるクリチカル セクションと、その間の障害により起きうるエラーの状態を示します。</p>
<div class="lset">
-図4. 長いクリチカル・セクション<br>
+図4. 長いクリチカル セクション<br>
<img src="../img/f4.png" width="320" height="436" alt="fig.4">
</div>
<div class="lset">
-図5. 最小化したクリチカル・セクション<br>
+図5. 最小化したクリチカル セクション<br>
<img src="../img/f5.png" width="320" height="436" alt="fig.5">
</div>
<br class="clr">
-<p>赤で示したセクションを実行中に障害が発生した場合、クロス・リンクが発生して操作対象のファイル・ディレクトリが失われる可能性があります。黄色で示したセクションを実行中に障害が発生した場合、つぎのうちいずれかまたは複数の結果が生じる可能性があります。</p>
+<p>赤で示したセクションを実行中に障害が発生した場合、クロス リンクが発生して操作対象のファイル ディレクトリが失われる可能性があります。黄色で示したセクションを実行中に障害が発生した場合、つぎのうちいずれかまたは複数の結果が生じる可能性があります。</p>
<ul>
<li>書き換え中のファイルのデータが破壊される。</li>
<li>追記中のファイルがオープン前の状態に戻る。</li>
@@ -241,7 +241,7 @@ _FS_LOCK 0 (Disable file lock control) <li>新規または上書きで作成されたファイルの長さがゼロになって残る。</li>
<li>ロストチェーンの発生によりボリュームの利用効率が悪化する。</li>
</ul>
-<p>いずれも書き込み中や操作の対象でないファイルには影響はありません。これらのクリチカル・セクションは、ファイルを書き込みモードで開いている時間を最小限にするか、<tt>f_sync()</tt>を適宜使用することで図5のようにリスクを最小化することができます。</p>
+<p>いずれも書き込み中や操作の対象でないファイルには影響はありません。これらのクリチカル セクションは、ファイルを書き込みモードで開いている時間を最小限にするか、<tt>f_sync()</tt>を適宜使用することで図5のようにリスクを最小化することができます。</p>
</div>
<div class="para" id="fs3">
@@ -258,23 +258,23 @@ _FS_LOCK 0 (Disable file lock control) <div class="para" id="license">
<h3>FatFsのライセンスについて</h3>
-<p>ソース・ファイルのヘッダにライセンス条件が記述されているので、利用の際はそれに従うこと。英語を読めない方のために以下に日本語訳を示しておきます。</p>
+<p>ソース ファイルのヘッダにライセンス条件が記述されているので、利用の際はそれに従うこと。英語を読めない方のために以下に日本語訳を示しておきます。</p>
<pre>/*----------------------------------------------------------------------------/
/ FatFs - FAT file system module R0.10b (C)ChaN, 2014
/-----------------------------------------------------------------------------/
-/ FatFsモジュールは、小規模な組み込みシステム向けの汎用FATファイルシステム・
-/ モジュールです。これはフリー・ソフトウェアとして、教育・研究・開発のために
-/ 以下のライセンス・ポリシーの下で公開されています。
+/ FatFsモジュールは、小規模な組み込みシステム向けの汎用FATファイルシステム
+/ モジュールです。これはフリー ソフトウェアとして、教育・研究・開発のために
+/ 以下のライセンス ポリシーの下で公開されています。
/
/ Copyright (C) 2014, ChaN, all right reserved.
/
-/ * FatFsモジュールはフリー・ソフトウェアであり、また<em>無保証です</em>。
+/ * FatFsモジュールはフリー ソフトウェアであり、また<em>無保証です</em>。
/ * 用途に制限はありません。<em>あなたの責任の下において</em>、個人的・非営利的な
/ ものから商用製品の開発に及ぶ目的に使用・改変・再配布することができます。
-/ * ソース・コードを再配布するときは、上記の著作権表示を保持しなければなりません。
+/ * ソース コードを再配布するときは、上記の著作権表示を保持しなければなりません。
/
/-----------------------------------------------------------------------------/</pre>
-<p>要するにFatFsはタダで自由に使えるということです。ソース・コードを再配布するときは、このブロックをそのまま保持しておくこと。このようにFatFsはBSDライクなライセンスとしていますが、一つ大きな違いがあります。特に組み込み用途での利用価値を高めるため、バイナリ形式(ソース・コードを含まない形式全て)での再配布については、条件は設けていません。その場合は、FatFsおよびそのライセンス文書についてはドキュメントに明記してもしなくてもかまいません。これは、一条項BSDライセンスと等価ということです。もちろんGNU GPLプロジェクトとも共存可能です。何らかの変更を加えて再配布する際は、矛盾しない他のライセンス(GNU GPLや修正BSDライセンスなど)に変更することも可能です。</p>
+<p>要するにFatFsはタダで自由に使えるということです。ソース コードを再配布するときは、このブロックをそのまま保持しておくこと。このようにFatFsはBSDライクなライセンスとしていますが、一つ大きな違いがあります。特に組み込み用途での利用価値を高めるため、バイナリ形式(ソース コードを含まない形式全て)での再配布については、条件は設けていません。その場合は、FatFsおよびそのライセンス文書についてはドキュメントに明記してもしなくてもかまいません。これは、一条項BSDライセンスと等価ということです。もちろんGNU GPLプロジェクトとも共存可能です。何らかの変更を加えて再配布する際は、矛盾しない他のライセンス(GNU GPLや修正BSDライセンスなど)に変更することも可能です。</p>
</div>
<p class="foot"><a href="../00index_j.html">戻る</a></p>
diff --git a/fatfs/doc/ja/chdir.html b/fatfs/doc/ja/chdir.html index 4a68fe2..3b09207 100644 --- a/fatfs/doc/ja/chdir.html +++ b/fatfs/doc/ja/chdir.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/chdir.html">
@@ -13,25 +13,25 @@ <div class="para func">
<h2>f_chdir</h2>
-<p>JgEfBNgύX܂B</p>
+<p>カレント ディレクトリを変更します。</p>
<pre>
FRESULT f_chdir (
- const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] fBNgւ̃|C^ */</span>
+ const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] ディレクトリ名へのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>path</dt>
-<dd>ړΏۂ̃fBNg<a href="filename.html">pX</a>k<tt>'\0'</tt>I[̕w肵܂B</dd>
+<dd>移動対象のディレクトリの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列を指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -49,33 +49,33 @@ FRESULT f_chdir ( <div class="para desc">
-<h4></h4>
-<p>e{[̃JgEfBNgύX܂BJgEfBNǵÃ{[̃}Eg삪sꂽƂA[gEfBNgɏݒ肳܂BJgEfBNǵAt@CEVXeEIuWFNgɕێ邽߁Ã{[gpSẴ^XNɑĉe^܂B</p>
+<h4>解説</h4>
+<p>各ボリュームのカレント ディレクトリを変更します。カレント ディレクトリは、そのボリュームのマウント動作が行われたとき、ルート ディレクトリに初期設定されます。カレント ディレクトリは、ファイル システム オブジェクトに保持されるため、そのボリュームを使用する全てのタスクに対して影響を与えます。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_RPATH == 1</tt>̂ƂɎgp\ƂȂ܂B</p>
+<h4>対応情報</h4>
+<p><tt>_FS_RPATH == 1</tt>のときに使用可能となります。</p>
</div>
<div class="para exa">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
- <span class="c">/* JgEhCũJgEfBNgύX ([gdir1) */</span>
+ <span class="c">/* カレント ドライブのカレント ディレクトリを変更 (ルート下のdir1へ) */</span>
f_chdir("/dir1");
- <span class="c">/* hCu2̃JgEfBNgύX (efBNg) */</span>
+ <span class="c">/* ドライブ2のカレント ディレクトリを変更 (親ディレクトリへ) */</span>
f_chdir("2:..");
</pre>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="chdrive.html">f_chdrive</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/chdrive.html b/fatfs/doc/ja/chdrive.html index 305b0a7..7571d4e 100644 --- a/fatfs/doc/ja/chdrive.html +++ b/fatfs/doc/ja/chdrive.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/chdrive.html">
@@ -13,25 +13,25 @@ <div class="para func">
<h2>f_chdrive</h2>
-<p>JgEhCuύX܂B</p>
+<p>カレント ドライブを変更します。</p>
<pre>
FRESULT f_chdrive (
- const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] ΏۃhCuw肵܂ */</span>
+ const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] 対象ドライブを指定します */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>path</dt>
-<dd>JgEhCuɐݒ肷<a href="filename.html">_hCuԍ</a>w肷pXw肵܂B</dd>
+<dd>カレント ドライブに設定する<a href="filename.html">論理ドライブ番号</a>を指定するパス名を指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#id">FR_INVALID_DRIVE</a>
@@ -40,19 +40,19 @@ FRESULT f_chdrive ( <div class="para desc">
-<h4></h4>
-<p>JgEhCuύX܂BVXeN̏l̓hCu0łB̐ݒFatFsW[̐ÓIϐɋL^邽߁ASẴ^XNɑĉe^܂B</p>
+<h4>解説</h4>
+<p>カレント ドライブを変更します。システム起動時の初期値はドライブ0です。この設定はFatFsモジュールの静的変数に記録されるため、全てのタスクに対して影響を与えます。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_RPATH == 1</tt>ŁA<tt>_VOLUMES > 1</tt>̂ƂɎgp\ƂȂ܂B</p>
+<h4>対応情報</h4>
+<p><tt>_FS_RPATH == 1</tt>で、且つ<tt>_VOLUMES > 1</tt>のときに使用可能となります。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="chdir.html">f_chdir</a></tt></p>
</div>
diff --git a/fatfs/doc/ja/chmod.html b/fatfs/doc/ja/chmod.html index e0d113e..cb8f2b3 100644 --- a/fatfs/doc/ja/chmod.html +++ b/fatfs/doc/ja/chmod.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/chmod.html">
@@ -13,39 +13,39 @@ <div class="para func">
<h2>f_chmod</h2>
-<p>t@C܂̓TuEfBNg̑ύX܂B</p>
+<p>ファイルまたはサブ ディレクトリの属性を変更します。</p>
<pre>
FRESULT f_chmod (
- const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] IuWFNgւ̃|C^ */</span>
- BYTE <span class="arg">attr</span>, <span class="c">/* [IN] ݒl */</span>
- BYTE <span class="arg">mask</span> <span class="c">/* [IN] ύX}XN */</span>
+ const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] オブジェクト名へのポインタ */</span>
+ BYTE <span class="arg">attr</span>, <span class="c">/* [IN] 設定値 */</span>
+ BYTE <span class="arg">mask</span> <span class="c">/* [IN] 変更マスク */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>path</dt>
-<dd>ύXΏۂ̃IuWFNg<a href="filename.html">pX</a>k<tt>'\0'</tt>I[̕w肵܂B</dd>
+<dd>属性変更対象のオブジェクトの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列を指定します。</dd>
<dt>attr</dt>
-<dd>ݒ肷鑮Bw\ȑ͎̒ʂŁȂgݍ킹Ŏw肵܂Bw肳Ȃ͉܂B<br>
+<dd>設定する属性。指定可能な属性は次の通りで、これらの組み合わせで指定します。指定されなかった属性は解除されます。<br>
<table class="lst">
-<tr><th>l</th><th>Ӗ</th></tr>
-<tr><td>AM_RDO</td><td>[hEI[</td></tr>
-<tr><td>AM_ARC</td><td>A[JCu</td></tr>
-<tr><td>AM_SYS</td><td>VXe</td></tr>
-<tr><td>AM_HID</td><td>qhD</td></tr>
+<tr><th>値</th><th>意味</th></tr>
+<tr><td>AM_RDO</td><td>リード オンリー</td></tr>
+<tr><td>AM_ARC</td><td>アーカイブ</td></tr>
+<tr><td>AM_SYS</td><td>システム</td></tr>
+<tr><td>AM_HID</td><td>ヒドゥン</td></tr>
</table>
</dd>
<dt>mask</dt>
-<dd>ύX鑮̃}XNBw肵ݒ܂͉Aw肳Ȃ͏Ԃێ܂B<tt class="arg">attr</tt>Ɠlg܂B</dd>
+<dd>変更する属性のマスク。指定した属性が設定または解除され、指定されなかった属性は状態が保持されます。<tt class="arg">attr</tt>と同じ値を使います。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -65,19 +65,19 @@ FRESULT f_chmod ( <div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_FS_MINIMIZE == 0</tt>̂Ƃgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のとき使用可能です。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
- <span class="c">/* [hI[ZbgAA[JCuNAȂ͕ύXȂ */</span>
+ <span class="c">/* リードオンリーをセット、アーカイブをクリア、その他は変更しない */</span>
f_chmod("file.txt", AM_RDO, AM_RDO | AM_ARC);
</pre>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/close.html b/fatfs/doc/ja/close.html index cefd795..71d3c01 100644 --- a/fatfs/doc/ja/close.html +++ b/fatfs/doc/ja/close.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/close.html">
@@ -13,25 +13,25 @@ <div class="para func">
<h2>f_close</h2>
-<p>t@C܂B</p>
+<p>ファイルを閉じます。</p>
<pre>
FRESULT f_close (
- FIL* <span class="arg">fp</span> <span class="c">/* [IN] t@CEIuWFNgւ̃|C^ */</span>
+ FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクトへのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>悤Ƃt@C̃t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>閉じようとするファイルのファイル オブジェクト構造体へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -44,23 +44,23 @@ FRESULT f_close ( <div class="para desc">
-<h4></h4>
-<p>t@C܂B炩݂̏̍sꂽt@C̏ꍇALbVꂽ([h/CgEobt@̃f[^AύXꂽFATfBNg)̓fBXNɏ߂܂BIƁÃt@CEIuWFNg͖ɂȂÃł܂B</p>
-<p>t@CEIuWFNgǂݏop[hŁA<tt>_FS_LOCK</tt>IvVIĂȂꍇ́At@CɃt@CEIuWFNgj邱Ƃł܂BA͏̌݊̓_Ő͂܂B</p>
+<h4>解説</h4>
+<p>ファイルを閉じます。何らかの書き込みの行われたファイルの場合、キャッシュされた状態(リード/ライト バッファ上のデータ、変更されたFATやディレクトリ項目)はディスクに書き戻されます。関数が正常終了すると、そのファイル オブジェクトは無効になり、そのメモリも解放できます。</p>
+<p>ファイル オブジェクトが読み出し専用モードで、<tt>_FS_LOCK</tt>オプションが選択されていない場合は、ファイルを閉じずにファイル オブジェクトを破棄することもできます。しかし、これは将来の互換性の点で推奨はされません。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p>SĂ̍\Ŏgp\łB</p>
+<h4>対応情報</h4>
+<p>全ての構成で使用可能です。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<tt><a href="open.html">f_open</a>, <a href="read.html">f_read</a>, <a href="write.html">f_write</a>, <a href="sync.html">f_sync</a>, <a href="sfile.html">FIL</a>, <a href="sfatfs.html">FATFS</a></tt>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/closedir.html b/fatfs/doc/ja/closedir.html index 021e8c8..2ccafdb 100644 --- a/fatfs/doc/ja/closedir.html +++ b/fatfs/doc/ja/closedir.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/close.html">
@@ -13,25 +13,25 @@ <div class="para func">
<h2>f_closedir</h2>
-<p>fBNg܂B</p>
+<p>ディレクトリを閉じます。</p>
<pre>
FRESULT f_closedir (
- DIR* <span class="arg">dp</span> <span class="c">/* [IN] fBNgEIuWFNgւ̃|C^ */</span>
+ DIR* <span class="arg">dp</span> <span class="c">/* [IN] ディレクトリ オブジェクトへのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>dp</dt>
-<dd>悤ƂfBNg̃fBNgEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>閉じようとするディレクトリのディレクトリ オブジェクト構造体へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#ie">FR_INT_ERR</a>,
@@ -42,23 +42,23 @@ FRESULT f_closedir ( <div class="para desc">
-<h4></h4>
-<p>fBNg܂BIƁÃfBNgEIuWFNg͖ɂȂÃł܂B</p>
-<p><tt>_FS_LOCK</tt>IvVIĂȂꍇ́Ȁs킸ɃfBNgEIuWFNgj邱Ƃł܂BA͏̌݊̓_Ő͂܂B</p>
+<h4>解説</h4>
+<p>ディレクトリを閉じます。関数が正常終了すると、そのディレクトリ オブジェクトは無効になり、そのメモリも解放できます。</p>
+<p><tt>_FS_LOCK</tt>オプションが選択されていない場合は、この処理を行わずにディレクトリ オブジェクトを破棄することもできます。しかし、これは将来の互換性の点で推奨はされません。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_MINIMIZE <= 1</tt>̂Ƃgp\ɂȂ܂B</p>
+<h4>対応情報</h4>
+<p><tt>_FS_MINIMIZE <= 1</tt>のとき使用可能になります。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<tt><a href="opendir.html">f_opendir</a>, <a href="readdir.html">f_readdir</a>, <a href="sdir.html">DIR</a></tt>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/dinit.html b/fatfs/doc/ja/dinit.html index 9168c0b..6329150 100644 --- a/fatfs/doc/ja/dinit.html +++ b/fatfs/doc/ja/dinit.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/dinit.html">
@@ -13,34 +13,34 @@ <div class="para func">
<h2>disk_initialize</h2>
-<p>Xg[WEfoCX܂B</p>
+<p>ストレージ デバイスを初期化します。</p>
<pre>
DSTATUS disk_initialize (
- BYTE <span class="arg">pdrv</span> <span class="c">/* [IN] hCuԍ */</span>
+ BYTE <span class="arg">pdrv</span> <span class="c">/* [IN] 物理ドライブ番号 */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>pdrv</dt>
-<dd>Ώۂ̃foCXhCuԍ(0-9)w肳܂B</dd>
+<dd>対象のデバイスを識別する物理ドライブ番号(0-9)が指定されます。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
-<p>͖̊߂lƂăfBXNEXe[^XԂ܂BfBXNEXe[^X̏ڍׂɊւĂ<tt><a href="dstat.html">disk_status()</a></tt>QƂĂB</p>
+<h4>戻り値</h4>
+<p>この関数は戻り値としてディスク ステータスを返します。ディスク ステータスの詳細に関しては<tt><a href="dstat.html">disk_status()</a></tt>を参照してください。</p>
</div>
<div class="para desc">
-<h4></h4>
-<p>Xg[WEfoCXAf[^̓ǂݏȂǑSĂ̓삪\ȏԂɂ܂BƁA߂l<tt>STA_NOINIT</tt>tONA܂B</p>
-<p><em>AvP[V͂̊ĂяoĂ͂Ȃ܂BȂƁAFAT{[j\܂BG[ɂďKvȂƂ́A<tt>f_mount()</tt>gpĂB</em>FatFsW[́A}EgɂAKvɉĂ̊Ăяo܂B</p>
+<h4>解説</h4>
+<p>ストレージ デバイスを初期化し、データの読み書きなど全ての動作が可能な状態にします。関数が成功すると、戻り値の<tt>STA_NOINIT</tt>フラグがクリアされます。</p>
+<p><em>アプリケーションからはこの関数を呼び出してはなりません。さもないと、FATボリュームが破壊される可能性があります。エラー等により再初期化が必要なときは、<tt>f_mount()</tt>を使用してください。</em>FatFsモジュールは、自動マウント動作により、必要に応じてこの関数を呼び出します。</p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/dioctl.html b/fatfs/doc/ja/dioctl.html index 30e49e3..120d798 100644 --- a/fatfs/doc/ja/dioctl.html +++ b/fatfs/doc/ja/dioctl.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/dioctl.html">
@@ -13,83 +13,83 @@ <div class="para func">
<h2>disk_ioctl</h2>
-<p>ʓIȃf[^ǂݏȊÕXg[WEfoCX̂ɑlXȐs܂B</p>
+<p>一般的なデータ読み書き以外のストレージ デバイス自体に対する様々な制御を行います。</p>
<pre>
DRESULT disk_ioctl (
- BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] hCuԍ */</span>
- BYTE <span class="arg">cmd</span>, <span class="c">/* [IN] R}h */</span>
- void* <span class="arg">buff</span> <span class="c">/* [I/O] f[^nobt@ */</span>
+ BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] 物理ドライブ番号 */</span>
+ BYTE <span class="arg">cmd</span>, <span class="c">/* [IN] 制御コマンド */</span>
+ void* <span class="arg">buff</span> <span class="c">/* [I/O] データ受け渡しバッファ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>pdrv</dt>
-<dd>Ώۂ̃foCXhCuԍ(0-9)w肳܂B</dd>
+<dd>対象のデバイスを示す物理ドライブ番号(0-9)が指定されます。</dd>
<dt>cmd</dt>
-<dd>R}hER[hw肳܂B</dd>
+<dd>制御コマンド コードが指定されます。</dd>
<dt>buff</dt>
-<dd>R}hɈˑp[^obt@w|C^w肳܂Bp[^̎̂ȂR}h̏ꍇ́AlɈӖ͂܂B</dd>
+<dd>制御コマンドに依存したパラメータを授受するバッファを指すポインタが指定されます。パラメータの授受のないコマンドの場合は、値に意味はありません。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<dl class="ret">
<dt>RES_OK (0)</dt>
-<dd>IB</dd>
+<dd>正常終了。</dd>
<dt>RES_ERROR</dt>
-<dd>炩̃G[B</dd>
+<dd>何らかのエラーが発生した。</dd>
<dt>RES_PARERR</dt>
-<dd>R}hsB</dd>
+<dd>コマンドが不正。</dd>
<dt>RES_NOTRDY</dt>
-<dd>hCu\Ԃł͂ȂA܂͏ĂȂB</dd>
+<dd>ドライブが動作可能状態ではない、または初期化されていない。</dd>
</dl>
</div>
<div class="para desc">
-<h4></h4>
-<p>Xg[WEfoCX̎ނɂT|[gR}h͈قȂ܂AFatFsW[̂́A̔ėpR}ĥݎgpÃfoCXɈˑ͍s܂B</p>
+<h4>解説</h4>
+<p>ストレージ デバイスの種類によりサポートされるコマンドは異なりますが、FatFsモジュール自体は、次の汎用コマンドのみ使用し、特定のデバイスに依存した制御は行いません。</p>
<table class="lst">
-<caption>WioctlR}h</caption>
-<tr><th>R}h</th><th></th></tr>
-<tr><td>CTRL_SYNC</td><td>Xg[WEfoCX̃f[^ݏ܂BCgEobNELbVȂǂ݂ꍇ́A܂ĂȂf[^݂܂BfBAւ݂̏ꂼ<tt>disk_write()</tt>̓Ŋꍇ́ÃR}hɑĂ邱Ƃ͂܂B</td></tr>
-<tr><td>GET_SECTOR_COUNT</td><td><tt class="arg">buff</tt>̎w<tt>DWORD</tt>^ϐɃhCȗZN^Ԃ܂B<tt>f_mkfs()</tt><tt>f_fdisk()</tt>ĂяoA쐬{[̃TCY肷邽߂Ɏgp܂B</td></tr>
-<tr><td>GET_SECTOR_SIZE</td><td><tt class="arg">buff</tt>̎w<tt>WORD</tt>^ϐɃhCũZN^ETCYԂ܂BLl512A1024A2048܂4096łBZN^ETCYŒ\(<tt>_MAX_SS ==_MIN_SS</tt>)̂Ƃ͂̃R}h͎g邱Ƃ͂ȂAɂ̃ZN^ETCYœ삵ȂȂ܂B</td></tr>
-<tr><td>GET_BLOCK_SIZE</td><td><tt class="arg">buff</tt>̎w<tt>DWORD</tt>^ϐɃtbVȄubNETCY(ZN^P)Ԃ܂B132768͈̔͂2̗ݏ̒lłȂȂ܂Bsȏꍇ܂̓tbVEȊÕfBAł1Ԃ܂B<tt>f_mkfs()</tt>ł̂ݎgpA{[̃f[^̈͂̋EɃACg܂B</td></tr>
-<tr><td>CTRL_ERASE_SECTOR</td><td>tbVË̗̖IB<tt class="arg">buff</tt>̎w<tt>DWORD</tt>^zɂ͏̈ {JnZN^,IZN^} w肵ČĂяo܂B<tt>_USE_ERASE</tt>1̂ƂANX^ƂɌĂяo܂B́AATAR}hEZbgTrimR}hƓŁA̋@\T|[gȂꍇ͉Kv͂܂B܂A߂l̓`FbNꂸASɍsȂƂĂFatFs̓ɂ͉e܂B</td></tr>
+<caption>標準ioctlコマンド</caption>
+<tr><th>コマンド</th><th>解説</th></tr>
+<tr><td>CTRL_SYNC</td><td>デバイスのデータ書き込み処理を完了させます。ドライバがライト バック キャッシュなどを持っている場合は、書き込まれていないデータを即時書き込みます。メディア上への書き込みがそれぞれ<tt>disk_write()</tt>の中で完了する場合は、このコマンドに対してすることはありません。</td></tr>
+<tr><td>GET_SECTOR_COUNT</td><td>総セクタ数の取得。<tt class="arg">buff</tt>の指す<tt>DWORD</tt>型変数にドライブ上の総セクタ数を返します。<tt>f_mkfs()</tt>および<tt>f_fdisk()</tt>内から呼び出され、作成するボリュームのサイズを決定するために使用されます。</td></tr>
+<tr><td>GET_SECTOR_SIZE</td><td>セクタ サイズの取得。<tt class="arg">buff</tt>の指す<tt>WORD</tt>型変数にドライブのセクタ サイズを返します。有効値は512、1024、2048または4096です。セクタ サイズが固定(<tt>_MAX_SS ==_MIN_SS</tt>)のときはこのコマンドは使われることはなく、デバイスは常にそのセクタ サイズで動作しなければなりません。</td></tr>
+<tr><td>GET_BLOCK_SIZE</td><td>消去ブロック サイズの取得。<tt class="arg">buff</tt>の指す<tt>DWORD</tt>型変数にフラッシュ メモリの消去ブロック サイズ(セクタ単位)を返します。1から32768の範囲で2の累乗の値でなければなりません。ブロック サイズ不明またはフラッシュ メモリ以外のデバイスでは1を返します。<tt>f_mkfs()</tt>内でのみ使用され、作成されるボリュームのデータ領域はこの境界にアライメントされます。</td></tr>
+<tr><td>CTRL_TRIM</td><td>不必要セクタの通知。<tt class="arg">buff</tt>の指す<tt>DWORD</tt>型配列には不必要になった領域 {開始セクタ,終了セクタ} を指定して呼び出されます。TRIM機能が有効(<tt>_USE_TRIM == 1</tt>)で、クラスタが解放されるとき、およびフォーマット時に呼び出されます。これは、ATAコマンド セットのTrimコマンドと等価で、この機能をサポートしないデバイスは何もする必要はありません。また、戻り値はチェックされず、結果によってFatFsの動作が影響を受けることはありません。</td></tr>
</table>
-<p>FatFŝ̓foCXˑR}h[U`R}h͈؎gp܂AAvP[V牽炩̃foCX䂪sƕ֗ȂƂ܂BAvP[VŕWȊO̐䂪KvȂƂ́AKvɉă[U`R}hljėpƂ悢ł傤BɃR}h̗܂B</p>
+<p>FatFs自体はデバイス依存コマンドやユーザ定義コマンドは一切使用しませんが、アプリケーションから何らかのデバイス制御が行えると便利なことがあります。アプリケーション上で標準以外の制御が必要なときは、必要に応じてユーザ定義コマンドを追加して利用するとよいでしょう。次にコマンドの例を示します。</p>
<table class="lst">
-<caption>[U`ioctlR}h̗</caption>
-<tr><th>R}h</th><th></th></tr>
-<tr><td>CTRL_FORMAT</td><td>fBA̕tH[}bgs܂B<tt class="arg">buff</tt>NULLłȂƂAis\̂߂̃R[obÑAhX܂B</td></tr>
-<tr><td>CTRL_POWER_IDLE</td><td>foCXAChԂɂ܂Bʏ̓ǂݏvŃANeBuԂɖ߂ȂA<tt>STA_NOINIT</tt>tOZbgKv͂܂B</td></tr>
-<tr><td>CTRL_POWER_OFF</td><td>foCXVbg_EԂɂ܂B<tt>STA_NOINIT</tt>̓Zbg܂BfoCX<tt>disk_initialize()</tt>ŃANeBuԂɖ߂܂B</td></tr>
-<tr><td>CTRL_LOCK</td><td>[Uɂ郁fBA̎o֎~܂B</td></tr>
-<tr><td>CTRL_UNLOCK</td><td>[Uɂ郁fBA̎o܂B</td></tr>
-<tr><td>CTRL_EJECT</td><td>fBAro܂BA<tt>STA_NOINIT</tt><tt>STA_NODISK</tt>tO̓Zbg܂B</td></tr>
-<tr><td>MMC_GET_TYPE</td><td>J[hE^CvtO(b0:MMCv3, b1:SDv1, b2:SDv2+, b3:LBA)<tt class="arg">buff</tt>̎<tt>BYTE</tt>ϐɓǂݏo܂B(MMC/SDJ[hp)</td></tr>
-<tr><td>MMC_GET_CSD</td><td>CSDWX^̓e<tt class="arg">buff</tt>̎16oCg̃obt@ɓǂݏo܂B(MMC/SDJ[hp)</td></tr>
-<tr><td>MMC_GET_CID</td><td>CIDWX^̓e<tt class="arg">buff</tt>̎16oCg̃obt@ɓǂݏo܂B(MMC/SDJ[hp)</td></tr>
-<tr><td>MMC_GET_OCR</td><td>OCRWX^̓e<tt class="arg">buff</tt>̎4oCg̃obt@ɓǂݏo܂B(MMC/SDJ[hp)</td></tr>
-<tr><td>MMC_GET_SDSTAT</td><td>SD STATUSWX^̓e<tt class="arg">buff</tt>̎64oCg̃obt@ɓǂݏo܂B(SDJ[hp)</td></tr>
-<tr><td>ATA_GET_REV</td><td>rWER[h<tt class="arg">buff</tt>̎16oCg̃obt@ɓǂݏo܂B(ATA/CFJ[hp)</td></tr>
-<tr><td>ATA_GET_MODEL</td><td>fER[h<tt class="arg">buff</tt>̎40oCg̃obt@ɓǂݏo܂B(ATA/CFJ[hp)</td></tr>
-<tr><td>ATA_GET_SN</td><td>VAԍ<tt class="arg">buff</tt>̎20oCg̃obt@ɓǂݏo܂B(ATA/CFJ[hp)</td></tr>
+<caption>ユーザ定義ioctlコマンドの例</caption>
+<tr><th>コマンド</th><th>解説</th></tr>
+<tr><td>CTRL_FORMAT</td><td>メディアの物理フォーマットを行います。<tt class="arg">buff</tt>はNULLでないとき、進行表示のためのコールバック関数のアドレスを示します。</td></tr>
+<tr><td>CTRL_POWER_IDLE</td><td>デバイスをアイドル状態にします。通常の読み書き要求でアクティブ状態に戻るなら、<tt>STA_NOINIT</tt>フラグをセットする必要はありません。</td></tr>
+<tr><td>CTRL_POWER_OFF</td><td>デバイスをシャットダウン状態にします。<tt>STA_NOINIT</tt>はセットされます。デバイスは<tt>disk_initialize()</tt>でアクティブ状態に戻ります。</td></tr>
+<tr><td>CTRL_LOCK</td><td>ユーザによるメディアの取り出しを禁止します。</td></tr>
+<tr><td>CTRL_UNLOCK</td><td>ユーザによるメディアの取り出しを許可します。</td></tr>
+<tr><td>CTRL_EJECT</td><td>メディアを排出します。完了後、<tt>STA_NOINIT</tt>と<tt>STA_NODISK</tt>フラグはセットされます。</td></tr>
+<tr><td>MMC_GET_TYPE</td><td>カード タイプを示すフラグ(b0:MMCv3, b1:SDv1, b2:SDv2+, b3:LBA)を<tt class="arg">buff</tt>の示す<tt>BYTE</tt>変数に読み出します。(MMC/SDカード専用)</td></tr>
+<tr><td>MMC_GET_CSD</td><td>CSDレジスタの内容を<tt class="arg">buff</tt>の示す16バイトのバッファに読み出します。(MMC/SDカード専用)</td></tr>
+<tr><td>MMC_GET_CID</td><td>CIDレジスタの内容を<tt class="arg">buff</tt>の示す16バイトのバッファに読み出します。(MMC/SDカード専用)</td></tr>
+<tr><td>MMC_GET_OCR</td><td>OCRレジスタの内容を<tt class="arg">buff</tt>の示す4バイトのバッファに読み出します。(MMC/SDカード専用)</td></tr>
+<tr><td>MMC_GET_SDSTAT</td><td>SD STATUSレジスタの内容を<tt class="arg">buff</tt>の示す64バイトのバッファに読み出します。(SDカード専用)</td></tr>
+<tr><td>ATA_GET_REV</td><td>リビジョン コードを<tt class="arg">buff</tt>の示す16バイトのバッファに読み出します。(ATA/CFカード専用)</td></tr>
+<tr><td>ATA_GET_MODEL</td><td>モデル コードを<tt class="arg">buff</tt>の示す40バイトのバッファに読み出します。(ATA/CFカード専用)</td></tr>
+<tr><td>ATA_GET_SN</td><td>シリアル番号を<tt class="arg">buff</tt>の示す20バイトのバッファに読み出します。(ATA/CFカード専用)</td></tr>
</table>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p>[hEI[\ŁAZN^ETCYŒ\̂Ƃ́Å͕KvƂ܂B</p>
+<h4>対応情報</h4>
+<p>リード オンリー構成で、かつセクタ サイズ固定構成のときは、この関数は必要とされません。</p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/dread.html b/fatfs/doc/ja/dread.html index 18b4238..2dac64e 100644 --- a/fatfs/doc/ja/dread.html +++ b/fatfs/doc/ja/dread.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/dread.html">
@@ -13,59 +13,60 @@ <div class="para func">
<h2>disk_read</h2>
-<p>Xg[WEfoCXf[^ǂݏo܂B</p>
+<p>ストレージ デバイスからデータを読み出します。</p>
<pre>
DRESULT disk_read (
- BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] hCuԍ */</span>
- BYTE* <span class="arg">buff</span>, <span class="c">/* [OUT] ǂݏoobt@ւ̃|C^ */</span>
- DWORD <span class="arg">sector</span>, <span class="c">/* [IN] ǂݏoJnZN^ԍ */</span>
- UINT <span class="arg">count</span> <span class="c">/* [IN] ǂݏoZN^ */</span>
+ BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] 物理ドライブ番号 */</span>
+ BYTE* <span class="arg">buff</span>, <span class="c">/* [OUT] 読み出しバッファへのポインタ */</span>
+ DWORD <span class="arg">sector</span>, <span class="c">/* [IN] 読み出し開始セクタ番号 */</span>
+ UINT <span class="arg">count</span> <span class="c">/* [IN] 読み出すセクタ数 */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>pdrv</dt>
-<dd>Ώۂ̃foCXhCuԍ(0-9)w肳܂B</dd>
+<dd>対象のデバイスを示す物理ドライブ番号(0-9)が指定されます。シングル ドライブ システムでは、常に0が指定されます。</dd>
<dt>buff</dt>
-<dd>Xg[WEfoCXǂݏof[^i[<em>oCgz</em>w肳܂B</dd>
+<dd>ストレージ デバイスから読み出したデータを格納する<em>バイト配列</em>が指定されます。</dd>
<dt>sector</dt>
-<dd>ǂݏoJnZN^ԍBLBAŎw肳܂B</dd>
+<dd>読み出しを開始するセクタ番号。32ビットLBAで指定されます。</dd>
<dt>count</dt>
-<dd>ǂݏoZN^BFatFšĂяoł1`128͈̔͂Ɍ܂B</dd>
+<dd>読み出すセクタ数(1～128)。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<dl class="ret">
<dt>RES_OK (0)</dt>
-<dd>IB</dd>
+<dd>正常終了。</dd>
<dt>RES_ERROR</dt>
-<dd>ǂݍݒɃG[ẢɂsB</dd>
+<dd>読み込み中にエラーが発生し、その回復にも失敗した。</dd>
<dt>RES_PARERR</dt>
-<dd>p[^sB</dd>
+<dd>パラメータが不正。</dd>
<dt>RES_NOTRDY</dt>
-<dd>hCu\Ԃł͂ȂiĂȂjB</dd>
+<dd>ドライブが動作可能状態ではない(初期化されていない)。</dd>
</dl>
</div>
<div class="para desc">
-<h4></h4>
-<p><tt class="arg">buff</tt><tt>BYTE</tt>^Ȃ̂ŁAw肳AhX<em>Ƀ[hEACgĂƂ͌܂</em>BACgEAhXւ̓]́A<a href="appnote.html#fs1">ړ]</a>ɂĔ邱Ƃ܂BAn[hEFA̐ł̂悤ȓ]s\ȂƂ́Åœi]Ȃǂĉ邩A܂͕ʂ̕@őΉȂȂ܂Bɂ̑Ή@܂(ꂩOK)B</p>
+<h4>解説</h4>
+<p>ストレージ デバイスに対するデータの読み書きは、セクタ単位で行われます。FatFsでは512～4096バイトのセクタ サイズをサポートします。固定セクタ サイズ構成(<tt>_MIN_SS == MAX_SS</tt>)のときは、暗黙的にそのセクタ サイズで動作しなければなりません。可変セクタ サイズ構成(<tt>_MIN_SS < MAX_SS</tt>)</p>のときは、初期化後<tt>disk_ioctl()</tt>でセクタ サイズを問い合わせてくるので、それに対して正しい値を返す必要があります。</t>
+<p><tt class="arg">buff</tt>は<tt>BYTE</tt>型なので、指定されるアドレスは<em>常にワード アライメントされているとは限りません</em>。非アライメント アドレスへの転送は、<a href="appnote.html#fs1">直接転送</a>において発生することがあります。もしも、ハードウェア上の制約でそのような転送が不可能なときは、この関数内で二段転送するなどして解決するか、または別の方法で対応しなければなりません。次にいくつかの対応方法を示します(いずれか一つでOK)。</p>
<ul>
-<li>̊ʼn - </li>
-<li><tt>f_read()</tt>ɂāAZN^Ŝ܂ޓ] - ړ]Ȃ</li>
-<li><tt>f_read(fp, buff, btr, &br)</tt>ɂāA<tt>(((UINT)buff & 3) == (f_tell(fp) & 3))</tt> - <tt class="arg">buff</tt>̃[hEACgۏ</li>
+<li>この関数内で解決する - 推奨</li>
+<li><tt>f_read()</tt>において、セクタ全体を含む転送を避ける - 直接転送が発生しない</li>
+<li><tt>f_read(fp, buff, btr, &br)</tt>において、<tt>(((UINT)buff & 3) == (f_tell(fp) & 3))</tt>を満足させる - <tt class="arg">buff</tt>のワード アライメントが保証される</li>
</ul>
-<p>ʓIɁAZN^̓]v́AXg[WEfoCXɑĉ\Ȍ}`EZN^]ȂȂ܂B̃VOEZN^ǂݏoɕꂽꍇAX[vbgቺ邱Ƃ܂B</p>
+<p>一般的に、複数セクタの転送要求は、ストレージ デバイスに対して可能な限りマルチ セクタ転送しなければなりません。複数のシングル セクタ読み出しに分解された場合、スループットが低下することがあります。</p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/dstat.html b/fatfs/doc/ja/dstat.html index a74fc30..6a30944 100644 --- a/fatfs/doc/ja/dstat.html +++ b/fatfs/doc/ja/dstat.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/dstat.html">
@@ -13,36 +13,36 @@ <div class="para func">
<h2>disk_status</h2>
-<p>Xg[WEfoCX̏Ԃ擾܂B</p>
+<p>ストレージ デバイスの状態を取得します。</p>
<pre>
DSTATUS disk_status (
- BYTE <span class="arg">pdrv</span> <span class="c">/* [IN] hCuԍ */</span>
+ BYTE <span class="arg">pdrv</span> <span class="c">/* [IN] 物理ドライブ番号 */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>pdrv</dt>
-<dd>Ώۂ̃foCXhCuԍ(0-9)w肳܂B</dd>
+<dd>対象のデバイスを識別する物理ドライブ番号(0-9)が指定されます。物理ドライブが1台のときは、常に0になります。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
-<p>Xg[WEfoCX̏Ԃ̃tȎgݍ킹lŕԂ܂B</p>
+<h4>戻り値</h4>
+<p>現在のストレージ デバイスの状態を次のフラグの組み合わせ値で返します。</p>
<dl class="ret">
<dt>STA_NOINIT</dt>
-<dd>foCXĂȂƂtOBVXeEZbgfBA̎OŃZbgA<tt>disk_initialize()</tt>̐IŃNAAsŃZbg܂BfBA͔ɔCxgȂ̂ŁAߋɃfBAꍇ̃tOɔfKv܂BFatFsW[́ÃtOQƂĎ}Egsǂf܂B</dd>
+<dd>デバイスが初期化されていないことを示すフラグ。システム リセットやメディアの取り外し等でセットされ、<tt>disk_initialize()</tt>の正常終了でクリア、失敗でセットされます。メディア交換は非同期に発生するイベントなので、過去にメディア交換があった場合もこのフラグに反映させる必要があります。FatFsモジュールは、このフラグを参照してマウント動作が必要かどうかを判断します。</dd>
<dt>STA_NODISK</dt>
-<dd>fBA݂ȂƂtOBfBAOĂԂ̓ZbgAZbgĂԂ̓NA܂BŒfBXNł͏ɃNA܂BȂÃtOFatFsW[ł͎QƂ܂B</dd>
+<dd>メディアが存在しないことを示すフラグ。メディアが取り外されている間はセットされ、セットされている間はクリアされます。固定ディスクでは常にクリアします。なお、このフラグはFatFsモジュールでは参照されません。</dd>
<dt>STA_PROTECT</dt>
-<dd>fBACgEveNgĂ邱ƂtOBCgEveNg@\T|[gȂƂ́AɃNA܂B[hEI\ł͎QƂ܂B</dd>
+<dd>メディアがライト プロテクトされていることを示すフラグ。ライト プロテクト機能をサポートしないときは、常にクリアします。リード オンリ構成では参照されません。</dd>
</dl>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/dwrite.html b/fatfs/doc/ja/dwrite.html index 41cebeb..15d4ead 100644 --- a/fatfs/doc/ja/dwrite.html +++ b/fatfs/doc/ja/dwrite.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/dwrite.html">
@@ -13,64 +13,64 @@ <div class="para func">
<h2>disk_write</h2>
-<p>Xg[WEfoCXɃf[^݂܂B</p>
+<p>ストレージ デバイスにデータを書き込みます。</p>
<pre>
DRESULT disk_write (
- BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] hCuԍ */</span>
- const BYTE* <span class="arg">buff</span>, <span class="c">/* [IN] ރf[^ւ̃|C^ */</span>
- DWORD <span class="arg">sector</span>, <span class="c">/* [IN] ݊JnZN^ԍ */</span>
- UINT <span class="arg">count</span> <span class="c">/* [IN] ރZN^ */</span>
+ BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] 物理ドライブ番号 */</span>
+ const BYTE* <span class="arg">buff</span>, <span class="c">/* [IN] 書き込むデータへのポインタ */</span>
+ DWORD <span class="arg">sector</span>, <span class="c">/* [IN] 書き込み開始セクタ番号 */</span>
+ UINT <span class="arg">count</span> <span class="c">/* [IN] 書き込むセクタ数 */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>pdrv</dt>
-<dd>Ώۂ̃foCXhCuԍ(0-9)w肳܂B</dd>
+<dd>対象のデバイスを示す物理ドライブ番号(0-9)が指定されます。</dd>
<dt>buff</dt>
-<dd>Xg[WEfoCXɏރZN^Ef[^i[ꂽ<em>oCgz</em>w肳܂BoCǵAZN^ETCY*<tt class="arg">count</tt>ƂȂ܂B</dd>
+<dd>ストレージ デバイスに書き込むセクタ データが格納された<em>バイト配列</em>が指定されます。バイト数は、セクタ サイズ*<tt class="arg">count</tt>となります。</dd>
<dt>sector</dt>
-<dd>݂JnZN^ԍBLBAŎw肳܂B</dd>
+<dd>書き込みを開始するセクタ番号。32ビットLBAで指定されます。</dd>
<dt>count</dt>
-<dd>ރZN^BFatFšĂяoł1`128͈̔͂Ɍ܂B</dd>
+<dd>書き込むセクタ数(1～128)。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<dl class="ret">
<dt>RES_OK (0)</dt>
-<dd>IB</dd>
+<dd>正常終了。</dd>
<dt>RES_ERROR</dt>
-<dd>ݒɃG[ẢɂsB</dd>
+<dd>書き込み中にエラーが発生し、その回復にも失敗した。</dd>
<dt>RES_WRPRT</dt>
-<dd>fBA֎~ԁB</dd>
+<dd>メディアが書き込み禁止状態。</dd>
<dt>RES_PARERR</dt>
-<dd>p[^sB</dd>
+<dd>パラメータが不正。</dd>
<dt>RES_NOTRDY</dt>
-<dd>foCX\Ԃł͂ȂiĂȂjB</dd>
+<dd>デバイスが動作可能状態ではない（初期化されていない）。</dd>
</dl>
</div>
<div class="para desc">
-<h4></h4>
-<p><tt class="arg">buff</tt>Ɏw肳AhX<em>Ƀ[hEACgĂƂ͌܂</em>Bڍׂ́A<a href="dread.html"><tt>disk_read()</tt></a>̉QƂĂB</p>
-<p>ʓIɁAZN^̓]v́AfoCXɑĉ\Ȍ}`EZN^]ȂȂ܂B̃VOEZN^݂ɕꂽꍇAX[vbgቺ邱Ƃ܂B</p>
-<p>FatFs̓fBXNx@\Ƃz肵Ă܂B̊߂ƂAfoCXݒƂLbVɏ܂ꂽȂǁAKf[^݂̏ĂKv͂܂BA<tt class="arg">buff</tt>̃f[^́Å߂ƖƂȂ܂B̗݊v́A<tt><a href="dioctl.html">disk_ioctl()</a></tt><tt>CTRL_SYNC</tt>R}hɂčs܂B̂悤Ȓx@\ꂽꍇAX[vbgɌコ邱Ƃł܂B</p>
-<p><em>AvP[V͂̊ĂяoĂ͂Ȃ܂BȂƁAFAT{[j\܂B</em></p>
+<h4>解説</h4>
+<p><tt class="arg">buff</tt>に指定されるアドレスは<em>常にワード アライメントされているとは限りません</em>。詳細は、<a href="dread.html"><tt>disk_read()</tt></a>の解説を参照してください。</p>
+<p>一般的に、複数セクタの転送要求は、デバイスに対して可能な限りマルチ セクタ転送しなければなりません。複数のシングル セクタ書き込みに分解された場合、スループットが著しく低下することがあります。</p>
+<p>FatFsはディスク関数が遅延書き込み機能を持つことも想定しています。この関数から戻るとき、デバイスが書き込み中とかキャッシュに書き込まれただけなど、必ずしもメディアへの書き込みが完了している必要はありません。ただし、<tt class="arg">buff</tt>のデータは、この関数から戻ると無効となります。書き込み完了の要求は、<tt><a href="dioctl.html">disk_ioctl()</a></tt>の<tt>CTRL_SYNC</tt>コマンドによって行われます。このような遅延書き込み機能が実装された場合、スループットをさらに向上させることができます。</p>
+<p><em>アプリケーションからはこの関数を呼び出してはなりません。さもないと、FATボリュームが破壊される可能性があります。</em></p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p>[hEI[\(<tt>_FS_READONLY == 1</tt>)ł͕͂̊KvƂ܂B</p>
+<h4>対応情報</h4>
+<p>リード オンリー構成(<tt>_FS_READONLY == 1</tt>)ではこの関数は必要とされません。</p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/eof.html b/fatfs/doc/ja/eof.html index b1f0e1a..b9098b3 100644 --- a/fatfs/doc/ja/eof.html +++ b/fatfs/doc/ja/eof.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/eof.html">
@@ -13,50 +13,50 @@ <div class="para func">
<h2>f_eof</h2>
-<p>[h/CgE|C^t@CI[ɒBĂ邩ǂׂ܂B.</p>
+<p>リード/ライト ポインタがファイル終端に達しているかどうか調べます。.</p>
<pre>
int f_eof (
- FIL* <span class="arg">fp</span> <span class="c">/* [IN] t@CEIuWFNg */</span>
+ FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
-<p>[h/CgE|C^t@CI[ɂǂݏof[^Ȃꍇ́A0ȊO̒lԂ܂BȊO̎0Ԃ܂B</p>
+<h4>戻り値</h4>
+<p>リード/ライト ポインタがファイル終端にあり読み出すデータがない場合は、0以外の値を返します。それ以外のときは0を返します。</p>
</div>
<div class="para desc">
-<h4></h4>
-<p>f_eof́ArWł̓}NƂĎĂ܂B</p>
+<h4>解説</h4>
+<p>f_eof関数は、現リビジョンではマクロとして実装されています。</p>
<pre>
-<span class="k">#define</span> f_eof(fp) (((fp)->fptr) == ((fp)->fsize) ? 1 : 0)
+<span class="k">#define</span> f_eof(fp) ((int)((fp)->fptr == (fp)->fsize))
</pre>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p>Ɏgp\B</p>
+<h4>対応情報</h4>
+<p>常に使用可能。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="lseek.html">f_lseek</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/error.html b/fatfs/doc/ja/error.html index ccd2f07..bb01d80 100644 --- a/fatfs/doc/ja/error.html +++ b/fatfs/doc/ja/error.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/error.html">
@@ -13,50 +13,50 @@ <div class="para func">
<h2>f_error</h2>
-<p>G[̗Lׂ܂B</p>
+<p>エラー発生の有無を調べます。</p>
<pre>
int f_error (
- FIL* <span class="arg">fp</span> <span class="c">/* [IN] t@CEIuWFNg */</span>
+ FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
-<p>t@C쒆̃G[ɂďfĂꍇ́A0ȊO̒lԂ܂BȊO̎0Ԃ܂B</p>
+<h4>戻り値</h4>
+<p>そのファイルにおいてハード エラーによって処理が中断されている場合は、0以外の値を返します。それ以外の時は0を返します。</p>
</div>
<div class="para desc">
-<h4></h4>
-<p>f_erroŕArWł̓}NƂĎĂ܂B</p>
+<h4>解説</h4>
+<p>f_error関数は、現リビジョンではマクロとして実装されています。</p>
<pre>
-<span class="k">#define</span> f_error(fp) (((fp)->flag & FA__ERROR) ? 1 : 0)
+<span class="k">#define</span> f_error(fp) ((fp)->err)
</pre>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p>Ɏgp\B</p>
+<h4>対応情報</h4>
+<p>常に使用可能。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/fattime.html b/fatfs/doc/ja/fattime.html index 028ad53..c8bbed7 100644 --- a/fatfs/doc/ja/fattime.html +++ b/fatfs/doc/ja/fattime.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/fattime.html">
@@ -13,7 +13,7 @@ <div class="para func">
<h2>get_fattime</h2>
-<p>ݎ擾܂B</p>
+<p>現在時刻を取得します。</p>
<pre>
DWORD get_fattime (void);
</pre>
@@ -21,37 +21,37 @@ DWORD get_fattime (void); <div class="para ret">
-<h4>߂l</h4>
-<p>݂̃[JE^C<tt>DWORD</tt>lɃpbNĕԂ܂BrbgEtB[h͎Ɏ悤ɂȂ܂B</p>
+<h4>戻り値</h4>
+<p>現在のローカル タイムを<tt>DWORD</tt>値にパックして返します。ビット フィールドは次に示すようになります。</p>
<dl>
<dt>bit31:25</dt>
-<dd>1980NN_ƂN 0..127 ŃZbgB</dd>
+<dd>1980年を起点とした年を 0..127 でセット。</dd>
<dt>bit24:21</dt>
-<dd> 1..12 ̒lŃZbgB</dd>
+<dd>月を 1..12 の値でセット。</dd>
<dt>bit20:16</dt>
-<dd> 1..31 ̒lŃZbgB</dd>
+<dd>日を 1..31 の値でセット。</dd>
<dt>bit15:11</dt>
-<dd> 0..23 ̒lŃZbgB</dd>
+<dd>時を 0..23 の値でセット。</dd>
<dt>bit10:5</dt>
-<dd> 0..59 ̒lŃZbgB</dd>
+<dd>分を 0..59 の値でセット。</dd>
<dt>bit4:0</dt>
-<dd>b/2 0..29 ̒lŃZbg</dd>
+<dd>秒/2を 0..29 の値でセット</dd>
</dl>
</div>
<div class="para desc">
-<h4></h4>
-<p>RTCT|[gȂVXełA_~[Ƃĉ炩̓tƂėLȒlԂׂłB0ȂǂԂꍇÃt@C̃^CX^v͖ɂȂ܂B</p>
+<h4>解説</h4>
+<p>RTCをサポートしないシステムでも、ダミーとして何らかの日付として有効な値を返すべきです。0などを返した場合、そのファイルのタイムスタンプは無効になります。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p>[hEI[\(<tt>_FS_READONLY == 1</tt>)ł͕͂̊KvƂ܂B</p>
+<h4>対応情報</h4>
+<p>リード オンリー構成(<tt>_FS_READONLY == 1</tt>)ではこの関数は必要とされません。</p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/fdisk.html b/fatfs/doc/ja/fdisk.html index 27f78b3..53b6cbb 100644 --- a/fatfs/doc/ja/fdisk.html +++ b/fatfs/doc/ja/fdisk.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/fdisk.html">
@@ -13,30 +13,30 @@ <div class="para func">
<h2>f_fdisk</h2>
-<p>hCu܂B</p>
+<p>物理ドライブを分割します。</p>
<pre>
FRESULT f_fdisk (
- BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] hCuԍ */</span>
- const DWORD <span class="arg">part[]</span>, <span class="c">/* [IN] }bvEe[u */</span>
- void* <span class="arg">work</span> <span class="c">/* [-] [NGA */</span>
+ BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] 物理ドライブ番号 */</span>
+ const DWORD <span class="arg">part[]</span>, <span class="c">/* [IN] 区画マップ テーブル */</span>
+ void* <span class="arg">work</span> <span class="c">/* [-] ワークエリア */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>pdrv</dt>
-<dd><em>hCu</em>̃hCuԍw肵܂B</dd>
+<dd>分割する<em>物理ドライブ</em>のドライブ番号を指定します。</dd>
<dt>part[]</dt>
-<dd>}bvEe[uւ̃|C^w肵܂B</dd>
+<dd>区画マップ テーブルへのポインタを指定します。</dd>
<dt>work</dt>
-<dd>[NGAւ̃|C^w肵܂BTCY<tt>_MAX_SS</tt>oCgKvłB</dd>
+<dd>ワークエリアへのポインタを指定します。サイズは<tt>_MAX_SS</tt>バイト必要です。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -47,41 +47,41 @@ FRESULT f_fdisk ( </div>
<div class="para desc">
-<h4></h4>
-<p>̊́Aw肳ꂽhCuMBRɋe[u쐬܂B敪͈ʓIFDISK`ōs߁Aő4̊{쐬邱Ƃł܂Bgɂ͑ΉĂ܂B}bve[u<tt class="arg">part[]</tt>ɂ̓hCuǂ̂悤ɕ邩w肵ēn܂B̔z4̍ڂ琬A擪̍ڂ1Ԗڂ́AŌ̍ڂ4Ԗڂ̋̃TCY܂Bl100ȉ̏ꍇAhCȗeʂɑ銄p[ZgPʂŎw肵܂B100l̏ꍇ̓ZN^̒ڎwɂȂ܂B</p>
+<h4>説明</h4>
+<p>この関数は、指定された物理ドライブのMBRに区画テーブルを作成します。区画分けは一般的なFDISK形式で行うため、最大4つの基本区画を作成することができます。拡張区画には対応していません。区画マップテーブル<tt class="arg">part[]</tt>にはドライブをどのように分割するか指定して渡します。この配列は4つの項目から成り、先頭の項目が1番目の、最後の項目が4番目の区画のサイズを示します。値が100以下の場合、ドライブの総容量に対する割合をパーセント単位で指定します。100を超える値の場合はセクタ数の直接指定になります。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READOLNY == 0</tt> <tt>_USE_MKFS == 1</tt> <tt>_MULTI_PARTITION == 1</tt> ̂Ƃgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READOLNY == 0</tt> で <tt>_USE_MKFS == 1</tt> で <tt>_MULTI_PARTITION == 1</tt> のとき使用可能です。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
- <span class="c">/* [U`̃{[Ǘe[u (_MULTI_PARTITION == 1 ̂ƂKv) */</span>
+ <span class="c">/* ユーザ定義のボリューム管理テーブル (_MULTI_PARTITION == 1 のとき必要) */</span>
PARTITION VolToPart[] = {
- {0, 1}, <span class="c">/* _hCu 0 ==> hCu 0, 1 */</span>
- {0, 2}, <span class="c">/* _hCu 1 ==> hCu 0, 2 */</span>
- {1, 0} <span class="c">/* _hCu 2 ==> hCu 1, o */</span>
+ {0, 1}, <span class="c">/* 論理ドライブ 0 ==> 物理ドライブ 0, 第1区画 */</span>
+ {0, 2}, <span class="c">/* 論理ドライブ 1 ==> 物理ドライブ 0, 第2区画 */</span>
+ {1, 0} <span class="c">/* 論理ドライブ 2 ==> 物理ドライブ 1, 自動検出 */</span>
};
</pre>
<pre>
- <span class="c">/* VhCu(0)̏ */</span>
+ <span class="c">/* 新しい物理ドライブ(0)の初期化 */</span>
FATFS fs;
- DWORD plist[] = {50, 50, 0, 0}; <span class="c">/* 2 */</span>
+ DWORD plist[] = {50, 50, 0, 0}; <span class="c">/* 2分割 */</span>
BYTE work[_MAX_SS];
- f_fdisk(0, plist, work); <span class="c">/* hCu 0 ̕ */</span>
+ f_fdisk(0, plist, work); <span class="c">/* 物理ドライブ 0 の分割 */</span>
f_mount(&fs "0:", 0);
- f_mkfs("0:", 0, 0); <span class="c">/* _hCu 0 ̃tH[}bg. ͖. */</span>
+ f_mkfs("0:", 0, 0); <span class="c">/* 論理ドライブ 0 のフォーマット. 第二引数は無視される. */</span>
f_mount(0, "0:", 0);
f_mount(&fs, "1:", 0);
- f_mkfs("1:", 0, 0); <span class="c">/* _hCu 0 ̃tH[}bg. ͖. */</span>
+ f_mkfs("1:", 0, 0); <span class="c">/* 論理ドライブ 0 のフォーマット. 第二引数は無視される. */</span>
f_mount(0, "1:", 0);
</pre>
diff --git a/fatfs/doc/ja/filename.html b/fatfs/doc/ja/filename.html index c57d7aa..524566c 100644 --- a/fatfs/doc/ja/filename.html +++ b/fatfs/doc/ja/filename.html @@ -12,28 +12,28 @@ <body>
<h1>パス名のフォーマット</h1>
<div class="para" id="nam">
-<h3>ファイル・ディレクトリ名</h3>
+<h3>ファイル ディレクトリ名</h3>
<p>FatFsモジュールでのファイル、ディレクトリ、ドライブの指定方法はDOS/Windows APIとほぼ同じです。パス名のフォーマットは次の通りです。</p>
<pre>"[論理ドライブ番号:][/]ディレクトリ名/ファイル名"</pre>
-<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>
+<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>
<p>ヌル文字や制御文字(<tt>'\0'</tt>～<tt>'\x1F'</tt>)は、パス名の終端として認識されます。パス名に先行あるいは中に含まれるスペースは、LFN構成では名前の一部として有効ですが、非LFN構成ではスペースはパス名の終端として認識されます。</p>
-<p>標準構成(<tt>_FS_RPATH == 0</tt>)のときは、全てのオブジェクトがルート・ディレクトリから辿る絶対パスで指定されます。OS指向なカレント・ディレクトリという概念は無く、またドット・ディレクトリ("."や"..")は使用できません。パス名先頭のセパレータは無視されます。デフォルト・ドライブ番号は常に0になります。</p>
-<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>
+<p>標準構成(<tt>_FS_RPATH == 0</tt>)のときは、全てのオブジェクトがルート ディレクトリから辿る絶対パスで指定されます。OS指向なカレント ディレクトリという概念は無く、またドット ディレクトリ("."や"..")は使用できません。パス名先頭のセパレータは無視されます。デフォルト ドライブ番号は常に0になります。</p>
+<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>
<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 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>
+<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>
-<p>また、<tt>_STR_VOLUME_ID</tt>オプションを有効にすることでドライブ番号の識別には数字のほか、任意の文字列を使用することも可能になります。</p>
+<p>また、<tt>_STR_VOLUME_ID</tt>オプションを有効にすることでドライブ番号の識別には数字のほか、<tt>"sd:file1.txt"</tt>や<tt>"ram:swapfile.dat"</tt>のように、任意の文字列を使用することも可能になります。</p>
</div>
<p><br></p>
@@ -62,13 +62,13 @@ PARTITION VolToPart[] = { {0, 3}, <span class="c">/* 論理ドライブ 2 ==> 物理ドライブ 0, 第3区画 */</span>
{1, 0} <span class="c">/* 論理ドライブ 3 ==> 物理ドライブ 1, 自動検出 */</span>
};
-
-<img src="../img/f7.png" width="828" height="288" alt="論理ドライブと物理ドライブの関係">
</pre>
+<div><img src="../img/f7.png" width="828" height="288" alt="論理ドライブと物理ドライブの関係"></div>
<p>複数区画指定を使用する場合、次の点に注意しなければなりません。
<ul>
-<li>マウント可能な区画は基本区画のみで、拡張区画内には対応しない。</li>
<li>複数のマウントされた区画を持つ物理ドライブは、非リムーバブルでなければならず、システム動作中のメディア交換は禁止。</li>
+<li>基本区画のみマウント可能で、拡張区画内の区画には対応しない。</li>
+<li>Windowsは、リムーバブル ドライブでは複数区画をサポートせず、先頭区画のみ認識する。</li>
</ul>
</div>
diff --git a/fatfs/doc/ja/forward.html b/fatfs/doc/ja/forward.html index ffb2e60..e9212ce 100644 --- a/fatfs/doc/ja/forward.html +++ b/fatfs/doc/ja/forward.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/forward.html">
@@ -13,34 +13,34 @@ <div class="para func">
<h2>f_forward</h2>
-<p>t@Cf[^ǂݏoAMXg[ɒړ]܂B</p>
+<p>ファイルからデータを読み出し、送信ストリームに直接転送します。</p>
<pre>
FRESULT f_forward (
- FIL* <span class="arg">fp</span>, <span class="c">/* [IN] t@CEIuWFNg\ */</span>
- UINT (*<span class="arg">func</span>)(const BYTE*,UINT), <span class="c">/* [IN] f[^] */</span>
- UINT <span class="arg">btf</span>, <span class="c">/* [IN] ]oCg */</span>
- UINT* <span class="arg">bf</span> <span class="c">/* [OUT] ]ꂽoCg */</span>
+ FIL* <span class="arg">fp</span>, <span class="c">/* [IN] ファイル オブジェクト構造体 */</span>
+ UINT (*<span class="arg">func</span>)(const BYTE*,UINT), <span class="c">/* [IN] データ転送関数 */</span>
+ UINT <span class="arg">btf</span>, <span class="c">/* [IN] 転送するバイト数 */</span>
+ UINT* <span class="arg">bf</span> <span class="c">/* [OUT] 転送されたバイト数 */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
<dt>func</dt>
-<dd>f[^n[U`ւ̃|C^w肵܂B̊̎dl̓TvQƂĂB</dd>
+<dd>データを渡すユーザ定義関数へのポインタを指定します。この関数の仕様はサンプルを参照してください。</dd>
<dt>btf</dt>
-<dd>]oCg(0`UINT̍ől)w肵܂B</dd>
+<dd>転送するバイト数(0～UINTの最大値)を指定します。</dd>
<dt>bf</dt>
-<dd>ۂɓ]ꂽoCgi[ϐw|C^w肵܂B</dd>
+<dd>実際に転送されたバイト数を格納する変数を指すポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -54,40 +54,40 @@ FRESULT f_forward ( <div class="para desc">
-<h4></h4>
-<p>t@C̃f[^obt@ɓǂݏoɑMXg[ɒړ]܂BAvP[VŃf[^Eobt@KvƂȂ̂ŁǍꂽŗLłB[h/CgE|C^͓]ꂽoCgi݂܂Bw肳ꂽoCg̓]Ƀt@C̏I[ɒBꍇMXg[rW[ɂȂꍇA<tt class="arg">*bf</tt><tt class="arg">btf</tt>Ȃ܂B</p>
+<h4>解説</h4>
+<p>ファイルのデータをバッファに読み出さずに送信ストリームに直接転送します。アプリケーション側でデータ バッファを必要としないので、メモリの限られた環境で有効です。リード/ライト ポインタは転送されたバイト数だけ進みます。指定されたバイト数の転送中にファイルの終端に達した場合や送信ストリームがビジーになった場合、<tt class="arg">*bf</tt>は<tt class="arg">btf</tt>よりも小さくなります。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_USE_FORWARD == 1</tt>ŁA<tt>_FS_TINY == 1</tt>̂ƂɎgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_USE_FORWARD == 1</tt>で、且つ<tt>_FS_TINY == 1</tt>のときに使用可能です。</p>
</div>
<div class="para use">
-<h4>gpiI[fBIĐj</h4>
+<h4>使用例（オーディオ再生）</h4>
<pre>
<span class="c">/*-----------------------------------------------------------------------*/</span>
-<span class="c">/* f_forwardĂf[^M̗ */</span>
+<span class="c">/* f_forward関数から呼ばれるデータ送信関数の例 */</span>
<span class="c">/*-----------------------------------------------------------------------*/</span>
-UINT out_stream ( <span class="c">/* ߂l: ]ꂽoCg܂̓Xg[̏ */</span>
- const BYTE *p, <span class="c">/* ]f[^w|C^ */</span>
- UINT btf <span class="c">/* >0: ]s(oCg). 0: Xg[̏Ԃׂ */</span>
+UINT out_stream ( <span class="c">/* 戻り値: 転送されたバイト数またはストリームの状態 */</span>
+ const BYTE *p, <span class="c">/* 転送するデータを指すポインタ */</span>
+ UINT btf <span class="c">/* >0: 転送を行う(バイト数). 0: ストリームの状態を調べる */</span>
)
{
UINT cnt = 0;
- if (btf == 0) { <span class="c">/* ZXv */</span>
- <span class="c">/* Xg[̏ԂԂ (0: rW[, 1: fB) */</span>
- <span class="c">/* UAfBԂA]vŏȂƂ1oCg */</span>
- <span class="c">/* ]Ȃ f_forward FR_INT_ERR ƂȂB */</span>
+ if (btf == 0) { <span class="c">/* センス要求 */</span>
+ <span class="c">/* ストリームの状態を返す (0: ビジー, 1: レディ) */</span>
+ <span class="c">/* 一旦、レディを返したら、続く転送要求で少なくとも1バイトは */</span>
+ <span class="c">/* 転送されないと f_forward関数は FR_INT_ERR となる。 */</span>
if (FIFO_READY) cnt = 1;
}
- else { <span class="c">/* ]v */</span>
- do { <span class="c">/* SẴoCg]邩AXg[rW[ɂȂ܂ŌJԂ */</span>
+ else { <span class="c">/* 転送要求 */</span>
+ do { <span class="c">/* 全てのバイトを転送するか、ストリームがビジーになるまで繰り返す */</span>
FIFO_PORT = *p++;
cnt++;
} while (cnt < btf && FIFO_READY);
@@ -98,31 +98,31 @@ UINT out_stream ( <span class="c">/* ߂l: ]ꂽoCg܂̓Xg[ <span class="c">/*-----------------------------------------------------------------------*/</span>
-<span class="c">/* f_forward̎gp */</span>
+<span class="c">/* f_forward関数の使用例 */</span>
<span class="c">/*-----------------------------------------------------------------------*/</span>
FRESULT play_file (
- char *fn <span class="c">/* ĐI[fBIEt@Cw|C^ */</span>
+ char *fn <span class="c">/* 再生するオーディオ ファイル名を指すポインタ */</span>
)
{
FRESULT rc;
FIL fil;
UINT dmy;
- <span class="c">/* t@Cǂݏo[hŊJ */</span>
+ <span class="c">/* ファイルを読み出しモードで開く */</span>
rc = f_open(&fil, fn, FA_READ);
if (rc) return rc;
- <span class="c">/* SẴf[^]邩G[܂ő */</span>
+ <span class="c">/* 全てのデータが転送されるかエラーが発生するまで続ける */</span>
while (rc == FR_OK && fil.fptr < fil.fsize) {
- <span class="c">/* ق̏... */</span>
+ <span class="c">/* ほかの処理... */</span>
- <span class="c">/* I܂͗vɉăf[^Xg[ɑo */</span>
+ <span class="c">/* 定期的または要求に応じてデータをストリームに送出する */</span>
rc = f_forward(&fil, out_stream, 1000, &dmy);
}
- <span class="c">/* t@CĖ߂ */</span>
+ <span class="c">/* ファイルを閉じて戻る */</span>
f_close(&fil);
return rc;
}
@@ -131,10 +131,10 @@ FRESULT play_file ( <div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="gets.html">fgets</a>, <a href="write.html">f_write</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/getcwd.html b/fatfs/doc/ja/getcwd.html index b48f3fc..24e4844 100644 --- a/fatfs/doc/ja/getcwd.html +++ b/fatfs/doc/ja/getcwd.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/getcwd.html">
@@ -13,28 +13,28 @@ <div class="para func">
<h2>f_getcwd</h2>
-<p>JgEfBNg܂B</p>
+<p>カレント ディレクトリを得ます。</p>
<pre>
FRESULT f_getcwd (
- TCHAR* <span class="arg">buff</span>, <span class="c">/* [OUT] obt@ */</span>
- UINT <span class="arg">len</span> <span class="c">/* [IN] obt@ETCY */</span>
+ TCHAR* <span class="arg">buff</span>, <span class="c">/* [OUT] バッファ */</span>
+ UINT <span class="arg">len</span> <span class="c">/* [IN] バッファ サイズ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>buff</dt>
-<dd>JgEfBNg̃pXi[obt@</dd>
+<dd>カレント ディレクトリのパス名文字列を格納するバッファ</dd>
<dt>len</dt>
-<dd><tt>TCHAR</tt>Pʂ̃obt@ETCY</dd>
+<dd><tt>TCHAR</tt>単位のバッファ サイズ</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -49,22 +49,22 @@ FRESULT f_getcwd ( <div class="para desc">
-<h4></h4>
-<p>JgEhCũJgEfBNg̃tEpX擾܂B<tt>_VOLUMES</tt>2ȏ̂Ƃ́A_hCuԍ̕tꂽpXƂȂ܂B</p>
+<h4>解説</h4>
+<p>カレント ドライブのカレント ディレクトリのフル パス文字列を取得します。<tt>_VOLUMES</tt>が2以上のときは、論理ドライブ番号の付加されたパス名となります。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_RPATH == 2</tt>̂Ƃgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_RPATH == 2</tt>のとき使用可能です。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="chdrive.html">f_chdrive</a>, <a href="chdir.html">f_chdir</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/getfree.html b/fatfs/doc/ja/getfree.html index 4de40de..8b99c76 100644 --- a/fatfs/doc/ja/getfree.html +++ b/fatfs/doc/ja/getfree.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/getfree.html">
@@ -13,31 +13,31 @@ <div class="para func">
<h2>f_getfree</h2>
-<p>{[̋̈̃TCY擾܂B</p>
+<p>ボリューム上の空き領域のサイズを取得します。</p>
<pre>
FRESULT f_getfree (
- const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] ΏۃhCuw肵܂ */</span>
- DWORD* <span class="arg">nclst</span>, <span class="c">/* [OUT] NX^i[ϐւ̃|C^ */</span>
- FATFS** <span class="arg">fatfs</span> <span class="c">/* [OUT] t@CEVXeEIuWFNgw|C^ւ̃|C^ */</span>
+ const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] 対象ドライブを指定します */</span>
+ DWORD* <span class="arg">nclst</span>, <span class="c">/* [OUT] 空きクラスタ数を格納する変数へのポインタ */</span>
+ FATFS** <span class="arg">fatfs</span> <span class="c">/* [OUT] ファイル システム オブジェクトを指すポインタへのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>path</dt>
-<dd>ׂΏۂ̘_hCu<a href="filename.html">pX</a>k<tt>'\0'</tt>I[̕ւ̃|C^w肵܂Bk̓JgEhCuӖ܂B</dd>
+<dd>調べる対象の論理ドライブを示す<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。ヌル文字列はカレント ドライブを意味します。</dd>
<dt>nclst</dt>
-<dd>NX^i[<tt>DWORD</tt>^ϐւ̃|C^w肵܂B</dd>
+<dd>空きクラスタ数を格納する<tt>DWORD</tt>型変数へのポインタを指定します。</dd>
<dt>fatfs</dt>
-<dd>ΏۃhCũt@CEVXeEIuWFNgw|C^Ԃ܂B</dd>
+<dd>対象ドライブのファイル システム オブジェクトを指すポインタが返されます。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -52,33 +52,33 @@ FRESULT f_getfree ( <div class="para desc">
-<h4></h4>
-<p>_hCű̈̃TCYNX^PʂŎ擾܂BԂꂽt@CEVXeEIuWFNg<tt>csize</tt>oNX^̃ZN^Ă̂ŁAɃZN^Pʂ̋TCYvZł܂BFAT32{[ɂẮAFSINFȌۂ̋NX^ƓĂȂꍇAsmȒlԂ\܂B̖邽߁A<tt>_FS_NOFSINFO</tt>IvVŃ}Eg͕̏KtFATXL悤ɍ\邱Ƃł܂B</p>
+<h4>解説</h4>
+<p>論理ドライブ上の空き領域のサイズをクラスタ単位で取得します。返されたファイル システム オブジェクトの<tt>csize</tt>メンバがクラスタあたりのセクタ数を示しているので、これを元にセクタ単位の空きサイズが計算できます。FAT32ボリュームにおいては、FSINFOの情報が実際の空きクラスタ数と同期していない場合、不正確な値を返す可能性があります。この問題を避けるため、<tt>_FS_NOFSINFO</tt>オプションでマウント後の初回は必ずフルFATスキャンをするように構成することもできます。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_FS_MINIMIZE == 0</tt>̂Ƃgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のとき使用可能です。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
FATFS *fs;
DWORD fre_clust, fre_sect, tot_sect;
- <span class="c">/* hCu1̃{[ƋNX^ */</span>
+ <span class="c">/* ドライブ1のボリューム情報と空きクラスタ数を得る */</span>
res = f_getfree("1:", &fre_clust, &fs);
if (res) die(res);
- <span class="c">/* SZN^ƋZN^vZ */</span>
+ <span class="c">/* 全セクタ数と空きセクタ数を計算 */</span>
tot_sect = (fs->n_fatent - 2) * fs->csize;
fre_sect = fre_clust * fs->csize;
- <span class="c">/* {[Ŝ̃TCYƋ̃TCY\ (512oCg/ZN^Ɖ) */</span>
+ <span class="c">/* ボリューム全体のサイズと空きのサイズを表示 (512バイト/セクタと仮定) */</span>
printf("%10lu KiB total drive space.\n%10lu KiB available.\n",
tot_sect / 2, fre_sect / 2);
</pre>
@@ -86,10 +86,10 @@ FRESULT f_getfree ( <div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<tt><a href="sfatfs.html">FATFS</a></tt>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/getlabel.html b/fatfs/doc/ja/getlabel.html index 957d212..bfcad0d 100644 --- a/fatfs/doc/ja/getlabel.html +++ b/fatfs/doc/ja/getlabel.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/getlabel.html">
@@ -13,31 +13,31 @@ <div class="para func">
<h2>f_getlabel</h2>
-<p>{[Ex擾܂B</p>
+<p>ボリューム ラベルを取得します。</p>
<pre>
FRESULT f_getlabel (
- const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] ΏۃhCu */</span>
- TCHAR* <span class="arg">label</span>, <span class="c">/* [OUT] {[i[obt@ */</span>
- DWORD* <span class="arg">vsn</span> <span class="c">/* [OUT] {[EVAԍi[ϐ */</span>
+ const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] 対象ドライブ */</span>
+ TCHAR* <span class="arg">label</span>, <span class="c">/* [OUT] ボリューム名を格納するバッファ */</span>
+ DWORD* <span class="arg">vsn</span> <span class="c">/* [OUT] ボリューム シリアル番号を格納する変数 */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>path</dt>
-<dd>ΏۂƂȂ_hCu<a href="filename.html">pX</a>k<tt>'\0'</tt>I[̕ւ̃|C^w肵܂Bk̏ꍇ́AftHgEhCuw肵ƂɂȂ܂B</dd>
+<dd>対象となる論理ドライブの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。ヌル文字列の場合は、デフォルト ドライブを指定したことになります。</dd>
<dt>label</dt>
-<dd>{[i[zւ̃|C^w肵܂BȂƂ12vf̃TCYKvłB{[Ȃꍇ̓kԂ܂B̏svȂƂ̓kE|C^w肵ĂB</dd>
+<dd>ボリューム名を格納する配列へのポインタを指定します。少なくとも12要素のサイズが必要です。ボリューム名がない場合はヌル文字列が返されます。この情報が不要なときはヌル ポインタを指定してください。</dd>
<dt>vsn</dt>
-<dd>{[EVAԍi[<tt>DWORD</tt>^ϐւ̃|C^w肵܂B̏svȂƂ̓kE|C^w肵ĂB</dd>
+<dd>ボリューム シリアル番号を格納する<tt>DWORD</tt>型変数へのポインタを指定します。この情報が不要なときはヌル ポインタを指定してください。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -52,31 +52,31 @@ FRESULT f_getlabel ( <div class="para comp">
-<h4>Ή</h4>
-<p><tt>_USE_LABEL == 1</tt>̂ƂɎgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_USE_LABEL == 1</tt>のときに使用可能です。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
char str[12];
- <span class="c">/* ftHgEhCũ{[ */</span>
+ <span class="c">/* デフォルト ドライブのボリューム名を得る */</span>
f_getlabel("", str, 0);
- <span class="c">/* hCu2̃{[ */</span>
+ <span class="c">/* ドライブ2のボリューム名を得る */</span>
f_getlabel("2:", str, 0);
</pre>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<tt><a href="setlabel.html">f_setlabel</a></tt>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/gets.html b/fatfs/doc/ja/gets.html index 2babef0..74e0b22 100644 --- a/fatfs/doc/ja/gets.html +++ b/fatfs/doc/ja/gets.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/gets.html">
@@ -13,53 +13,53 @@ <div class="para func">
<h2>f_gets</h2>
-<p>t@C當ǂݏo܂B</p>
+<p>ファイルから文字列を読み出します。</p>
<pre>
TCHAR* f_gets (
- TCHAR* <span class="arg">buff</span>, <span class="c">/* [OUT] obt@ */</span>
- int <span class="arg">len</span>, <span class="c">/* [IN] obt@̃TCY */</span>
- FIL* <span class="arg">fp</span> <span class="c">/* [IN] t@CEIuWFNg */</span>
+ TCHAR* <span class="arg">buff</span>, <span class="c">/* [OUT] バッファ */</span>
+ int <span class="arg">len</span>, <span class="c">/* [IN] バッファのサイズ */</span>
+ FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>buff</dt>
-<dd>ǂݏoobt@w|C^w肵܂B</dd>
+<dd>文字列を読み出すバッファを指すポインタを指定します。</dd>
<dt>len</dt>
-<dd>obt@̃TCYvfŎw肵܂B</dd>
+<dd>バッファのサイズを要素数で指定します。</dd>
<dt>fp</dt>
-<dd>t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
-<p><tt class="arg">buff</tt>Ԃ܂B</p>
+<h4>戻り値</h4>
+<p>関数が成功すると<tt class="arg">buff</tt>が返されます。</p>
</div>
<div class="para desc">
-<h4></h4>
-<p>̊<a href="read.html"><tt>f_read()</tt></a>̃bp[łBǂݏóAŏ<tt>'\n'</tt>ǂݍނAt@CI[ɒB邩A<tt class="arg">len</tt> - 1ǂݏo܂ő܂Bǂݍ܂ꂽ̏I[ɂ<tt>'\0'</tt>t܂BɃt@CI[1ǂݍ܂ȂƂA܂͉炩̃G[Ƃ͎͊skE|C^Ԃ܂Bt@CI[G[<tt>f_eof()</tt>,<tt>f_error()</tt>}NŒׂ܂B</p>
-<p>Unicode API\(<tt>_LFN_UNICODE == 1</tt>)IĂƂ́A<tt class="arg">buff</tt>UTF-16ɂȂ܂At@C̃GR[h́A<tt>_STRF_ENCODE</tt>IvVőIł܂BȊO͖̎ϊ(1oCg/1)œǂݏo܂B</p>
+<h4>解説</h4>
+<p>この関数は<a href="read.html"><tt>f_read()</tt></a>のラッパー関数です。読み出し動作は、最初の<tt>'\n'</tt>を読み込むか、ファイル終端に達するか、<tt class="arg">len</tt> - 1文字を読み出すまで続きます。読み込まれた文字列の終端には<tt>'\0'</tt>が付加されます。既にファイル終端で1文字も読み込まれなかったとき、または何らかのエラーが発生したときは関数は失敗しヌル ポインタを返します。ファイル終端かエラーかは<tt>f_eof()</tt>,<tt>f_error()</tt>マクロで調べられます。</p>
+<p>Unicode API構成(<tt>_LFN_UNICODE == 1</tt>)が選択されているときは、<tt class="arg">buff</tt>はUTF-16文字列になりますが、ファイル上のエンコードは、<tt>_STRF_ENCODE</tt>オプションで選択できます。それ以外の時は無変換(1バイト/1文字)で読み出します。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_USE_STRFUNC</tt>1܂2̂Ƃgp\łB2̂Ƃ́At@CɊ܂܂<tt>'\r'</tt>菜ăobt@ɓǂݍ܂܂B</p>
+<h4>対応情報</h4>
+<p><tt>_USE_STRFUNC</tt>が1または2のとき使用可能です。2のときは、ファイルに含まれる<tt>'\r'</tt>が取り除かれてバッファに読み込まれます。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="read.html">f_read</a>, <a href="putc.html">f_putc</a>, <a href="puts.html">f_puts</a>, <a href="printf.html">f_printf</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/lseek.html b/fatfs/doc/ja/lseek.html index 5578852..88e1ab2 100644 --- a/fatfs/doc/ja/lseek.html +++ b/fatfs/doc/ja/lseek.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/lseek.html">
@@ -13,28 +13,28 @@ <div class="para func">
<h2>f_lseek</h2>
-<p>t@C̃[h/CgE|C^ړ܂B܂AV[N@\gpɂCLMT(q)̍쐬ɂgp܂B</p>
+<p>ファイルのリード/ライト ポインタを移動します。また、高速シーク機能使用時にはCLMT(後述)の作成にも使用します。</p>
<pre>
FRESULT f_lseek (
- FIL* <span class="arg">fp</span>, <span class="c">/* [IN] t@CEIuWFNg\̂ւ̃|C^ */</span>
- DWORD <span class="arg">ofs</span> <span class="c">/* [IN] ړItZbg */</span>
+ FIL* <span class="arg">fp</span>, <span class="c">/* [IN] ファイル オブジェクト構造体へのポインタ */</span>
+ DWORD <span class="arg">ofs</span> <span class="c">/* [IN] 移動先オフセット */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>ΏۂƂȂt@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>対象となるファイル オブジェクト構造体へのポインタを指定します。</dd>
<dt>ofs</dt>
-<dd>ړ̃ItZbg([h/CgE|C^)lBt@C擪̃ItZbgoCgPʂŎw肵܂B</dd>
+<dd>移動先のオフセット(リード/ライト ポインタ)値。ファイル先頭からのオフセットをバイト単位で指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -48,82 +48,82 @@ FRESULT f_lseek ( <div class="para desc">
-<h4></h4>
-<p>t@C̃[h/CgE|C^(ɓǂݏoE݂oCg̃ItZbg)ړ܂BItZbǧ_̓t@C擪łB݃[hŃt@CETCY傫Ȓlw肷ƁA܂Ńt@CETCYgAgꂽ̃f[^͖`ƂȂ܂Bf[^xɏ݂Ƃ́A\߂̊ŕKvȃTCY܂Ńt@CETCYgĂƗǂł傤B<tt>f_lseek()</tt>IƂ́A[h/CgE|C^ړ`FbNׂłB[h/CgE|C^w菬Ƃ́Ǎl܂B</p>
+<h4>解説</h4>
+<p>ファイルのリード/ライト ポインタ(次に読み出し・書き込みされるバイトのオフセット)を移動します。オフセットの原点はファイル先頭です。書き込みモードでファイル サイズより大きな値を指定すると、そこまでファイル サイズが拡張され、拡張された部分のデータは未定義となります。データを遅延無く高速に書き込みたいときは、予めこの関数で必要なサイズまでファイル サイズを拡張しておくと良いでしょう。<tt>f_lseek()</tt>が正常終了したあとは、リード/ライト ポインタが正しく移動したかチェックするべきです。リード/ライト ポインタが指定より小さいときは、次の原因が考えられます。</p>
<ul>
-<li>݃[h܂͍V[NE[ĥ߁At@CETCYŃNbvꂽB</li>
-<li>t@CgɃfBXNtɂȂB</li>
+<li>非書き込みモードまたは高速シーク モードのため、ファイル サイズでクリップされた。</li>
+<li>ファイル拡張中にディスクが満杯になった。</li>
</ul>
-<p><tt>_USE_FASTSEEK</tt>1ŁAt@CEIuWFNg<tt>cltbl</tt>oNULLȊO(<tt>f_open()</tt>NULLɐݒ肳)̂ƂAV[NE[hɂȂ܂B̓t@C̃NX^zu(CLMT)ɕێĂƂɂAFATɃANZX邱ƂȂV[NOEV[Nɍs@\łBV[NE[h́A<tt>f_read()/f_wtite()</tt>̓ɂKp܂BV[NE[hł<tt>f_wtite()/f_lseek()</tt>ɂt@CETCY̊g͂ł܂B</p>
-<p>V[NsOɁACLMT쐬ĂKv܂B쐬ɂ́A܂CLMTi[obt@(<tt>DWORD</tt>^z)A<tt>cltbl</tt>oɂ̃|C^Zbg܂BāAz̐擪vfɂ̔z̃TCY(vf)A<tt>f_lseek()</tt><tt class="arg">ofs</tt><tt>CREATE_LINKMAP</tt>w肵ČĂяo܂BCLMT쐬Aȍ~<tt>f_read()/f_write()/f_lseek()</tt>łFATւ̃ANZX͔܂B<tt>FR_NOT_ENOUGH_CORE</tt>ŎsƂ͔zTCYsŁA擪vfɂ͎ۂɕKvƂȂvfԂ܂BKvȗvf́A(t@C̕ + 1) * 2 łBƂAt@C5̃tOgɕfĂƂɕKvȗvf́A12ƂȂ܂B</p>
+<p><tt>_USE_FASTSEEK</tt>が1で、且つファイル オブジェクトの<tt>cltbl</tt>メンバがNULL以外(<tt>f_open()</tt>でNULLに設定される)のとき、高速シーク モードになります。これはファイルのクラスタ配置情報(CLMT)をメモリ上に保持しておくことにより、FATにアクセスすることなく後方シークやロング シークを高速に行う機能です。高速シーク モードは、<tt>f_read()/f_wtite()</tt>の動作にも適用されます。高速シーク モードでは<tt>f_wtite()/f_lseek()</tt>によるファイル サイズの拡張はできません。</p>
+<p>高速シーク動作を行う前に、CLMTを作成しておく必要があります。これを作成するには、まずCLMT格納バッファ(<tt>DWORD</tt>型配列)を準備し、<tt>cltbl</tt>メンバにそのポインタをセットします。そして、配列の先頭要素にその配列のサイズ(要素数)を入れ、<tt>f_lseek()</tt>を<tt class="arg">ofs</tt>に<tt>CREATE_LINKMAP</tt>を指定して呼び出します。関数が成功するとCLMTが作成され、以降の<tt>f_read()/f_write()/f_lseek()</tt>ではFATへのアクセスは発生しません。<tt>FR_NOT_ENOUGH_CORE</tt>で失敗したときは配列サイズが不足で、先頭要素には実際に必要となる要素数が返されます。必要な要素数は、(ファイルの分割数 + 1) * 2 です。たとえば、ファイルが5つのフラグメントに分断されているときに必要な要素数は、12となります。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_MINIMIZE < 3</tt>̂Ƃgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_MINIMIZE < 3</tt>のとき使用可能です。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
- <span class="c">/* t@CJ */</span>
+ <span class="c">/* ファイルを開く */</span>
fp = malloc(sizeof (FIL));
res = f_open(fp, "file.dat", FA_READ|FA_WRITE);
if (res) ...
- <span class="c">/* t@CEItZbg5000ֈړ */</span>
+ <span class="c">/* ファイル オフセット5000へ移動 */</span>
res = f_lseek(fp, 5000);
- <span class="c">/* t@CI[ֈړ(t@CNjL̏) */</span>
+ <span class="c">/* ファイル終端へ移動(ファイル追記の準備) */</span>
res = f_lseek(fp, f_size(fp));
- <span class="c">/* 3000oCgi߂ */</span>
+ <span class="c">/* 3000バイト進める */</span>
res = f_lseek(fp, f_tell(fp) + 3000);
- <span class="c">/* 2000oCg߂ (bvAEhɒ) */</span>
+ <span class="c">/* 2000バイト戻す (ラップアラウンドに注意) */</span>
res = f_lseek(fp, f_tell(fp) - 2000);
</pre>
<pre>
-<span class="c">/* NX^s蓖 (Xg[~OECg̃obt@EI[o[h~) */</span>
+<span class="c">/* クラスタ先行割り当て (ストリーミング ライト時のバッファ オーバーラン防止) */</span>
- res = f_open(fp, "record.wav", FA_CREATE_NEW | FA_WRITE); <span class="c">/* t@C쐬 */</span>
+ res = f_open(fp, "record.wav", FA_CREATE_NEW | FA_WRITE); <span class="c">/* ファイル作成 */</span>
- res = f_lseek(fp, MAX_SIZE); <span class="c">/* \ȃNX^̐s蓖 */</span>
- if (res || f_tell(fp) != PRE_SIZE) ... <span class="c">/* t@Cgꂽ`FbN */</span>
+ res = f_lseek(fp, MAX_SIZE); <span class="c">/* 十分なクラスタの先行割り当て */</span>
+ if (res || f_tell(fp) != PRE_SIZE) ... <span class="c">/* 正しくファイルが拡張されたかチェック */</span>
- res = f_lseek(fp, DATA_START); <span class="c">/* f[^EXg[̋L^(AP[VfBC) */</span>
+ res = f_lseek(fp, DATA_START); <span class="c">/* データ ストリームの記録(アロケーションディレイ無し) */</span>
...
- res = f_truncate(fp); <span class="c">/* sv̈̐̂ */</span>
- res = f_lseek(fp, 0); <span class="c">/* wb_̋L^ */</span>
+ res = f_truncate(fp); <span class="c">/* 不要領域の切り捨て */</span>
+ res = f_lseek(fp, 0); <span class="c">/* ヘッダの記録 */</span>
...
res = f_close(fp);
</pre>
<pre>
-<span class="c">/* V[N@\g */</span>
+<span class="c">/* 高速シーク機能を使う */</span>
- DWORD clmt[SZ_TBL]; <span class="c">/* NE}bvEe[ui[obt@ */</span>
+ DWORD clmt[SZ_TBL]; <span class="c">/* リンク マップ テーブル格納バッファ */</span>
- res = f_lseek(fp, ofs1); <span class="c">/* ʏV[N (I[vAcltblNULLɏ) */</span>
+ res = f_lseek(fp, ofs1); <span class="c">/* 通常シーク (オープン時、cltblはNULLに初期化される) */</span>
- fp->cltbl = clmt; <span class="c">/* V[N@\̗L */</span>
- clmt[0] = SZ_TBL; <span class="c">/* 擪vfɔzvfZbg */</span>
- res = f_lseek(fp, CREATE_LINKMAP); <span class="c">/* CLMT̍쐬 */</span>
+ fp->cltbl = clmt; <span class="c">/* 高速シーク機能の有効化 */</span>
+ clmt[0] = SZ_TBL; <span class="c">/* 先頭要素に配列要素数をセット */</span>
+ res = f_lseek(fp, CREATE_LINKMAP); <span class="c">/* CLMTの作成 */</span>
...
- res = f_lseek(fp, ofs2); <span class="c">/* ȍ~Af_read/f_write/f_lseekFATANZX͔Ȃ */</span>
+ res = f_lseek(fp, ofs2); <span class="c">/* 以降、f_read/f_write/f_lseekでFATアクセスは発生しない */</span>
</pre>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/mkdir.html b/fatfs/doc/ja/mkdir.html index ef107d3..63da707 100644 --- a/fatfs/doc/ja/mkdir.html +++ b/fatfs/doc/ja/mkdir.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/mkdir.html">
@@ -13,25 +13,25 @@ <div class="para func">
<h2>f_mkdir</h2>
-<p>fBNg쐬܂B</p>
+<p>ディレクトリを作成します。</p>
<pre>
FRESULT f_mkdir (
- const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] 쐬fBNgւ̃|C^ */</span>
+ const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] 作成するディレクトリ名へのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>path</dt>
-<dd>쐬fBNg<a href="filename.html">pX</a>k<tt>'\0'</tt>I[̕ւ̃|C^w肵܂B</dd>
+<dd>作成するディレクトリの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -52,19 +52,19 @@ FRESULT f_mkdir ( <div class="para desc">
-<h4></h4>
-<p>̃fBNg쐬܂B</p>
+<h4>解説</h4>
+<p>空のディレクトリを作成します。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_FS_MINIMIZE == 0</tt>̂Ƃgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のとき使用可能です。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
res = f_mkdir("sub1");
if (res) die(res);
@@ -75,6 +75,6 @@ FRESULT f_mkdir ( </pre>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/mkfs.html b/fatfs/doc/ja/mkfs.html index 7e09696..19b4341 100644 --- a/fatfs/doc/ja/mkfs.html +++ b/fatfs/doc/ja/mkfs.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/mkfs.html">
@@ -13,30 +13,30 @@ <div class="para func">
<h2>f_mkfs</h2>
-<p>_hCuFAT{[쐬(tH[}bg)܂B</p>
+<p>論理ドライブ上にFATボリュームを作成(フォーマット)します。</p>
<pre>
FRESULT f_mkfs (
- const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] _hCuԍ */</span>
- BYTE <span class="arg">sfd</span>, <span class="c">/* [IN] 쐬@ */</span>
- UINT <span class="arg">au</span> <span class="c">/* [IN] NXE^TCY */</span>
+ const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] 論理ドライブ番号 */</span>
+ BYTE <span class="arg">sfd</span>, <span class="c">/* [IN] 区画作成方法 */</span>
+ UINT <span class="arg">au</span> <span class="c">/* [IN] クラス タサイズ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>path</dt>
-<dd>tH[}bgΏۂ̘_hCu<a href="filename.html">pX</a>k<tt>'\0'</tt>I[̕ւ̃|C^w肵܂BhCuԍ܂܂Ȃꍇ́AJgEhCuӖ܂B</dd>
+<dd>フォーマット対象の論理ドライブを示す<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。ドライブ番号を含まない場合は、カレント ドライブを意味します。</dd>
<dt>sfd</dt>
-<dd>p[e[V`B(0(FDISK) ܂ 1(SFD))</dd>
+<dd>パーテーション形式。(0(FDISK) または 1(SFD))</dd>
<dt>au</dt>
-<dd>NX^ETCYoCgPʂŎw肵܂Bl͑ΏۃhCũZN^ETCYn{(n = 1`128ŁA2̗ݏ)łȂȂ܂B0Ȃǂ̖lw肵ꍇA{[̃TCYɉftHg̃NX^ETCYI܂B</dd>
+<dd>クラスタ サイズをバイト数またはセクタ数で指定します。値が1～128の範囲場合は、セクタ数を示します。値が<tt>_MIN_SS</tt>以上の場合は、バイト数を示します。無効値(0または2の累乗でない値など)を指定した場合、ボリュームのサイズに応じたデフォルトのクラスタ サイズが自動選択されます。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -48,26 +48,64 @@ FRESULT f_mkfs ( </div>
<div class="para desc">
-<h4></h4>
-<p>hCuFAT{[쐬܂BFDISK`w肳ꂽꍇ́AhCuŜ߂{(p[e[V)쐬A̒FAT{[쐬܂BSFD`ł́AFAT{[hCu̐擪ZN^x^ō쐬܂B</p>
-<p>tH[}bg_hCu}`Ep[e[V@\(<tt>_MULTI_PARTITION</tt>)ɂē̋(1`4)ɌѕtĂꍇ́A̋̒FAT{[쐬܂B<tt class="arg">sfd</tt>͖A܂Ή镨hCu͂ɐ旧A<tt>f_fdisk()</tt>܂͑̃c[œKɋݒ肳ĂKv܂B</p>
-<p>p[e[V`ɂ́AFDISK`SFD`̓ʂ肠܂BFDISK`́An[hfBXNAMMCASDCACFCAU DiskȂǂŕWIɎgp܂BFDISK`ł͈̕hCuɈ܂͕̋쐬邱Ƃł܂BǗMBR(hCu̐擪ZN^)ɋL^܂BSFD`͒Pɉ̕sȂ`ŁA{[͕hCu̐擪ZN^Jn܂BSFD`́Atbs[EfBXNA}CNhCuAwfBXNAт̑X[p[Etbs[EfBAŕWIɎgpĂ܂B</p>
-<p>FAT^Cv(FAT12/FAT16/FAT32)́Ã{[<em>NX^ɂĂ̂</em>錈܂[FATdl]ɂȂĂāAȊO̗v͂܂BāAǂFAT^CvɂȂ邩̓{[ETCYƃNX^ETCYɈˑ܂BNX^ETCY͑傫قǐ\オ܂B</p>
-<p>NX^FAT^Cv̋Eɋ߂ȂƂ́A<tt>FR_MKFS_ABORTED</tt>Ŋs\܂B</p>
+<h4>説明</h4>
+<p>物理ドライブ上にFATボリュームを作成します。FDISK形式が指定された場合は、物理ドライブ全体を占める基本区画(パーテーション)が作成され、その中にFATボリュームが作成されます。SFD形式では、FATボリュームが物理ドライブの先頭セクタからベタで作成されます。</p>
+<p>フォーマットする論理ドライブがマルチ パーテーション機能(<tt>_MULTI_PARTITION</tt>)によって特定の区画(1～4)に結び付けられている場合は、その区画の中にFATボリュームが作成されます。<tt class="arg">sfd</tt>は無視され、また対応する物理ドライブはこれに先立ち、<tt>f_fdisk()</tt>または他のツールで適切に区画設定されている必要があります。</p>
+<p>パーテーション形式には、FDISK形式とSFD形式の二通りあります。FDISK形式は、ハードディスク、MMC、SDC、CFC、U Diskなどで標準的に使用されます。FDISK形式では一台の物理ドライブ上に一つまたは複数の区画を作成することができます。区画管理情報はMBR(物理ドライブの先頭セクタ)に記録されます。SFD形式は単に何の分割も行わない形式で、ボリュームは物理ドライブの先頭セクタから開始します。SFD形式は、フロッピー ディスク、マイクロドライブ、光学ディスク、およびその他スーパー フロッピー メディアで標準的に使用されています。</p>
+<p>FATタイプ(FAT12/FAT16/FAT32)は、そのボリューム上の<em>クラスタ数によってのみ決定</em>される決まり[FAT仕様書より]になっていて、それ以外の要因はありません。したがって、どのFATタイプになるかはボリューム サイズとクラスタ サイズに依存します。クラスタ サイズは大きくするほど性能が上がります。</p>
+<p>クラスタ数がFATタイプの境界に近くなるときは、<tt>FR_MKFS_ABORTED</tt>で関数が失敗する可能性があります。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_USE_MKFS == 1</tt>̂Ƃgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_MKFS == 1</tt>のとき使用可能です。</p>
+</div>
+
+
+<div class="para use">
+<h4>使用例</h4>
+<pre>
+<span class="c">/* Format the default drive */</span>
+int main (void)
+{
+ FATFS fs; <span class="c">/* File system object (volume work area) */</span>
+ FIL fil; <span class="c">/* File object */</span>
+ FRESULT res; <span class="c">/* API result code */</span>
+ UINT bw; <span class="c">/* Bytes written */</span>
+
+
+ <span class="c">/* Register work area */</span>
+ f_mount(&fs, "", 0);
+
+ <span class="c">/* Create FAT volume with default cluster size */</span>
+ res = f_mkfs("", 0, 0);
+ if (res) ...
+
+ <span class="c">/* Create a file as new */</span>
+ res = f_open(&fil, "hello.txt", FA_CREATE_NEW | FA_WRITE);
+ if (res) ...
+
+ <span class="c">/* Write a message */</span>
+ f_write(&fil, "Hello, World!\r\n", 15, &bw);
+ if (bw != 15) ...
+
+ <span class="c">/* Close the file */</span>
+ f_close(&fil);
+
+ <span class="c">/* Unregister work area */</span>
+ f_mount(0, "", 0);
+
+</pre>
</div>
<div class="para ref">
-<h4>Q</h4>
-<p><tt><a href="filename.html#vol">{[Ǘ</a>, <a href="fdisk.html">f_fdisk</a></tt></p>
+<h4>参照</h4>
+<p><tt><a href="filename.html#vol">ボリューム管理</a>, <a href="fdisk.html">f_fdisk</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/mount.html b/fatfs/doc/ja/mount.html index c6bc9f1..d465edb 100644 --- a/fatfs/doc/ja/mount.html +++ b/fatfs/doc/ja/mount.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/mount.html">
@@ -13,30 +13,30 @@ <div class="para func">
<h2>f_mount</h2>
-<p>_hCuɃt@CEVXeEIuWFNgo^E܂B</p>
+<p>論理ドライブにファイル システム オブジェクトを登録・抹消します。</p>
<pre>
FRESULT f_mount (
- FATFS* <span class="arg">fs</span>, <span class="c">/* [IN] t@CEVXeEIuWFNg */</span>
- const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] _hCuԍ */</span>
- BYTE <span class="arg">opt</span> <span class="c">/* [IN] IvV */</span>
+ FATFS* <span class="arg">fs</span>, <span class="c">/* [IN] ファイル システム オブジェクト */</span>
+ const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] 論理ドライブ番号 */</span>
+ BYTE <span class="arg">opt</span> <span class="c">/* [IN] オプション */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fs</dt>
-<dd>o^t@CEVXeEIuWFNgւ̃|C^B</dd>
+<dd>登録するファイル システム オブジェクトへのポインタ。</dd>
<dt>path</dt>
-<dd>ΏۂƂȂ_hCu<a href="filename.html">pX</a>k'\0'I[̕ւ̃|C^w肵܂BhCuԍ܂܂Ȃꍇ́AftHgEhCuw肵ƂɂȂ܂B</dd>
+<dd>対象となる論理ドライブの<a href="filename.html">パス名</a>を示すヌル文字'\0'終端の文字列へのポインタを指定します。パス名にドライブ番号が含まれない場合は、デフォルト ドライブを指定したことになります。</dd>
<dt>opt</dt>
-<dd>t@CEVXeEIuWFNg̓o^ƓɃ}Egsǂw肷tOBo^̂Ƃ͈Ӗ܂B</dd>
+<dd>ファイル システム オブジェクトの登録と同時にマウント動作を行うかどうかを指定するフラグ。登録抹消のときは意味を持ちません。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#id">FR_INVALID_DRIVE</a>,
@@ -48,35 +48,35 @@ FRESULT f_mount ( <div class="para desc">
-<h4></h4>
-<p>FatFsW[ł́Aꂼ̘_hCu<em>t@CEVXeEIuWFNg</em>Ƃ[NEGAKvłB̊͘_hCuɃt@CEVXeEIuWFNgo^薕肵܂B炩̃t@CgpOɁÅł̘_hCũt@CEVXeEIuWFNg^ĂȂȂ܂B<tt class="arg">fs</tt>ɃkE|C^w肷ƁA̘_hCũt@CEVXeEIuWFNg̓o^͖邾łBo^ꂽt@CEVXeEIuWFNg͉̃ł܂BΏۂ̘_hCuɊJĂt@CfBNgꍇA͑SĖɂȂ܂B͎̊̓̂悤ȏɍs܂B</p>
+<h4>解説</h4>
+<p>FatFsモジュールでは、それぞれの論理ドライブに<em>ファイル システム オブジェクト</em>というワーク エリアが必要です。この関数は論理ドライブにファイル システム オブジェクトを登録したり抹消したりします。何らかのファイル関数を使用する前に、この関数でその論理ドライブのファイル システム オブジェクトを与えておかなければなりません。<tt class="arg">fs</tt>にヌル ポインタを指定すると、その論理ドライブのファイル システム オブジェクトの登録は抹消されるだけです。登録抹消されたファイル システム オブジェクトのメモリは解放できます。操作対象の論理ドライブ上に開かれたままのファイルやディレクトリがあった場合、それらに対して作成された構造体は全て無効になります。この関数の内部処理は次のような順に行われます。</p>
<ol>
-<li>Ώۂ̘_hCu<tt class="arg">path</tt>瓾B</li>
-<li>ɓo^Ăt@CEVXeEIuWFNg̓NAAo^B</li>
-<li><tt class="arg">fs</tt>Lȃ|C^̂Ƃ́Ãt@CEVXeEIuWFNgNAo^B</li>
-<li>}Eg삪w肳ĂƂ́AsB</li>
+<li>対象の論理ドライブを<tt class="arg">path</tt>から得る。</li>
+<li>既に登録されているファイル システム オブジェクトはクリアし、登録を解除する。</li>
+<li><tt class="arg">fs</tt>が有効なポインタのときは、そのファイル システム オブジェクトをクリアし登録する。</li>
+<li>マウント動作が指定されているときは、それを実行する。</li>
</ol>
-<p><tt class="arg">opt</tt>0w肷ƁA}Eg(hCȕAFAT{[̌ABPB͂t@CEVXeEIuWFNg)͍sꂸA͕hCȕԂɊւ炸ɐ܂Bł͉ʃCւ̃ANZX͔Aw肳ꂽt@CEVXeEIuWFNgNA()ÃAhXzɓo^邾łBPɓo^ς݂̃t@CEVXeEIuWFNgNAړIɂg܂BāAă{[ւ̃ANZXsꂽƂ̂ꂩł^̏ꍇ́Aۂ̃}Eg삪s܂B</p>
+<p><tt class="arg">opt</tt>に0を指定すると、マウント動作(物理ドライブの初期化、FATボリュームの検索、BPBを解析しファイル システム オブジェクトを初期化)は行われず、関数は物理ドライブの状態に関わらず常に成功します。関数内では下位レイヤへのアクセスは発生せず、指定されたファイル システム オブジェクトをクリア(無効化)し、そのアドレスを内部配列に登録するだけです。単に登録済みのファイル システム オブジェクトをクリアする目的にも使えます。実際のマウント動作は、ボリュームへのアクセス(パス名を渡すもの全て)が行われたときに、次のうちいずれかの条件が真の場合に行われます。</p>
<ul>
-<li>t@CEVXeEIuWFNgNA()(<tt>f_mount()</tt>̎sɂ)</li>
-<li>hCu(VXeEZbgfBǍɂ)</li>
+<li>ファイル システム オブジェクトがクリア(無効)状態(<tt>f_mount()</tt>の実行による)</li>
+<li>物理ドライブが未初期化状態(システム リセットやメディアの交換による)</li>
</ul>
-<p><tt class="arg">opt</tt>1w肷ƁAo^ɑă}Eg삪s܂B}EgɎsƑΉG[Ԃ܂Ao^͗LȂ̂ő{[ւ̃ANZXōĂу}Eg삪s܂B<p>
-<p>ʃC̎チfBǍoT|[gȂ(<tt>disk_status()</tt>ɔfȂ)Ƃ́AAvP[V̓fBǍケ̊Ńt@CEVXeEIuWFNgIɃNAčă}Egɍs悤ɂKv܂B</p>
+<p><tt class="arg">opt</tt>に1を指定すると、ファイル システムオブジェクトの登録に続きマウント動作が行われます。メディアが無いなどの理由でマウント動作に失敗すると対応するエラーを返しファイル システム オブジェクト無効状態のままになりますが、登録自体は有効なので続いてボリュームへのアクセスがあれば再びマウント動作が実行されます。</p>
+<p>下位レイヤの実装上メディア交換の検出がサポートされない(<tt>disk_status()</tt>に反映されない)ときは、アプリケーションはメディア交換の後この関数でファイル システム オブジェクトを明示的にクリアし、マウント動作が正常に行えるようにする必要があります。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p>SĂ̍\Ŏgp\łB</p>
+<h4>対応情報</h4>
+<p>全ての構成で使用可能です。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a></tt>, <tt><a href="sfatfs.html">FATFS</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/open.html b/fatfs/doc/ja/open.html index a4c4a18..c308398 100644 --- a/fatfs/doc/ja/open.html +++ b/fatfs/doc/ja/open.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/open.html">
@@ -13,33 +13,33 @@ <div class="para func">
<h2>f_open</h2>
-<p>t@CI[v܂͍쐬܂B</p>
+<p>ファイルをオープンまたは作成します。</p>
<pre>
FRESULT f_open (
- FIL* <span class="arg">fp</span>, <span class="c">/* [OUT] ̃t@CEIuWFNg\̂ւ̃|C^ */</span>
- const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] t@Cւ̃|C^ */</span>
- BYTE <span class="arg">mode</span> <span class="c">/* [IN] [htO */</span>
+ FIL* <span class="arg">fp</span>, <span class="c">/* [OUT] 空のファイル オブジェクト構造体へのポインタ */</span>
+ const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] ファイル名へのポインタ */</span>
+ BYTE <span class="arg">mode</span> <span class="c">/* [IN] モードフラグ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>V쐬t@CEIuWFNg\̂ւ̃|C^w肵܂Bȍ~Ãt@C܂ł̃t@CEIuWFNggpăt@C܂B</dd>
+<dd>新しく作成するファイル オブジェクト構造体へのポインタを指定します。以降、そのファイルを閉じるまでこのファイル オブジェクトを使用してファイル操作をします。</dd>
<dt>path</dt>
-<dd>Jt@C<a href="filename.html">t@C</a>k<tt>'\0'</tt>I[̕ւ̃|C^w肵܂B</dd>
+<dd>開くファイルの<a href="filename.html">ファイル名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd>
<dt>mode</dt>
-<dd>t@C̃ANZX@I[v@߂tOłB̃p[^ɂ͎̑gݍ킹w肵܂B<br>
+<dd>ファイルのアクセス方法やオープン方法を決めるフラグです。このパラメータには次の組み合わせを指定します。<br>
<table class="lst">
-<tr><th>l</th><th>Ӗ</th></tr>
-<tr><td>FA_READ</td><td>ǂݏo[hŊJ܂Bǂݏꍇ<tt>FA_WRITE</tt>ƋɎw肵܂B</td></tr>
-<tr><td>FA_WRITE</td><td>݃[hŊJ܂Bǂݏꍇ<tt>FA_READ</tt>ƋɎw肵܂B</td></tr>
-<tr><td>FA_OPEN_EXISTING</td><td>̃t@CJ܂Bt@CƂ̓G[ɂȂ܂B(ftHg)</td></tr>
-<tr><td>FA_OPEN_ALWAYS</td><td>̃t@CJ܂Bt@CƂ̓t@C쐬܂BNjL̏ꍇ́A̕@ŃI[vA<a href="lseek.html"><tt>f_lseek()</tt></a>Ńt@C̍ŌɈړĂB</td></tr>
-<tr><td>FA_CREATE_NEW</td><td>t@C쐬܂B̃t@Cꍇ́A<tt>FR_EXIST</tt>Ŏs܂B</td></tr>
-<tr><td>FA_CREATE_ALWAYS</td><td>t@C쐬܂B̃t@Cꍇ́ATCY0ɂĂJ܂B</td></tr>
+<tr><th>値</th><th>意味</th></tr>
+<tr><td>FA_READ</td><td>読み出しモードで開きます。読み書きする場合は<tt>FA_WRITE</tt>と共に指定します。</td></tr>
+<tr><td>FA_WRITE</td><td>書き込みモードで開きます。読み書きする場合は<tt>FA_READ</tt>と共に指定します。</td></tr>
+<tr><td>FA_OPEN_EXISTING</td><td>既存のファイルを開きます。ファイルが無いときはエラーになります。(デフォルト)</td></tr>
+<tr><td>FA_OPEN_ALWAYS</td><td>既存のファイルを開きます。ファイルが無いときはファイルを作成します。追記の場合は、この方法でオープンした後、<a href="lseek.html"><tt>f_lseek()</tt></a>でファイルの最後尾に移動してください。</td></tr>
+<tr><td>FA_CREATE_NEW</td><td>ファイルを作成します。同名のファイルがある場合は、<tt>FR_EXIST</tt>で失敗します。</td></tr>
+<tr><td>FA_CREATE_ALWAYS</td><td>ファイルを作成します。同名のファイルがある場合は、サイズを0にしてから開きます。</td></tr>
</table>
</dd>
</dl>
@@ -47,7 +47,7 @@ FRESULT f_open ( <div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -72,86 +72,86 @@ FRESULT f_open ( <div class="para desc">
-<h4></h4>
-<p>̃t@CJAVt@C쐬܂Bƃt@CEIuWFNg쐬Aȍ~̃t@CɑANZXɎgp܂Bt@CƂ́A<a href="close.html"><tt>f_close()</tt></a>gp܂B炩̕ύXsꂽt@Č㐳ȂꍇÃt@Cjꍇ܂B</p>
-<p>ɊJĂt@CJKvꍇ́A<a href="appnote.html#dup">dANZX</a>QƂĂBÃt@Cɑ鏑݃[h܂ޏdI[v͏ɋ֎~łB</p>
-<p>t@CEANZXJnOɁA<a href="mount.html"><tt>f_mount()</tt></a>gĂꂼ̘_hCuɃ[NEGA(t@CEVXeEIuWFNg)^Kv܂B̏̌A̘_hCuɑđSẴt@Cg悤ɂȂ܂B</p>
+<h4>解説</h4>
+<p>既存のファイルを開いたり、新しいファイルを作成します。関数が成功するとファイル オブジェクトが作成され、以降そのファイルに対するアクセスに使用します。ファイルを閉じるときは、<a href="close.html"><tt>f_close()</tt></a>を使用します。何らかの変更が行われたファイルがその後正しく閉じられなかった場合、そのファイルが破損する場合があります。</p>
+<p>既に開かれているファイルを開く必要がある場合は、<a href="appnote.html#dup">多重アクセス制御</a>を参照してください。しかし、一つのファイルに対する書き込みモードを含む重複オープンは常に禁止です。</p>
+<p>ファイル アクセスを開始する前に、<a href="mount.html"><tt>f_mount()</tt></a>を使ってそれぞれの論理ドライブにワーク エリア(ファイル システム オブジェクト)を与える必要があります。この初期化の後、その論理ドライブに対して全てのファイル関数が使えるようになります。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p>SĂ̍\Ŏgp\łB<tt>_FS_READONLY == 1</tt>̂Ƃ́A<tt>FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYS</tt>̊etO̓T|[g܂B</p>
+<h4>対応情報</h4>
+<p>全ての構成で使用可能です。<tt>_FS_READONLY == 1</tt>のときは、<tt>FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYS</tt>の各フラグはサポートされません。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
-<span class="c">/* eLXgt@Cǂݏoĕ\ */</span>
+<span class="c">/* テキストファイルを読み出して表示 */</span>
-FATFS FatFs; <span class="c">/* _hCũ[NEGA(t@CEVXeEIuWFNg) */</span>
+FATFS FatFs; <span class="c">/* 論理ドライブのワーク エリア(ファイル システム オブジェクト) */</span>
int main (void)
{
- FIL fil; <span class="c">/* t@CEIuWFNg */</span>
- char line[82]; <span class="c">/* sobt@ */</span>
- FRESULT fr; <span class="c">/* ߂l */</span>
+ FIL fil; <span class="c">/* ファイル オブジェクト */</span>
+ char line[82]; <span class="c">/* 行バッファ */</span>
+ FRESULT fr; <span class="c">/* 戻り値 */</span>
- <span class="c">/* ftHgEhCuɃ[NGA^ */</span>
+ <span class="c">/* デフォルト ドライブにワークエリアを与える */</span>
f_mount(&FatFs, "", 0);
- <span class="c">/* eLXgEt@CJ */</span>
+ <span class="c">/* テキスト ファイルを開く */</span>
fr = f_open(&fil, "message.txt", FA_READ);
if (fr) return (int)fr;
- <span class="c">/* 1sǂݏoĕ\ */</span>
+ <span class="c">/* 1行ずつ読み出して表示 */</span>
while (f_gets(line, sizeof line, &fil))
printf(line);
- <span class="c">/* t@C */</span>
+ <span class="c">/* ファイルを閉じる */</span>
f_close(&fil);
return 0;
}
</pre>
<pre>
-<span class="c">/* hCu1̃t@C "file.bin" hCu0փRs[ */</span>
+<span class="c">/* ドライブ1のファイル "file.bin" をドライブ0へコピー */</span>
int main (void)
{
- FATFS fs[2]; <span class="c">/* _hCũ[NGA(t@CEVXeEIuWFNg) */</span>
- FIL fsrc, fdst; <span class="c">/* t@CEIuWFNg */</span>
+ FATFS fs[2]; <span class="c">/* 論理ドライブのワークエリア(ファイル システム オブジェクト) */</span>
+ FIL fsrc, fdst; <span class="c">/* ファイル オブジェクト */</span>
BYTE buffer[4096]; <span class="c">/* File copy buffer */</span>
FRESULT fr; <span class="c">/* FatFs function common result code */</span>
UINT br, bw; <span class="c">/* File R/W count */</span>
- <span class="c">/* hCu0,1Ƀ[NEGA^ */</span>
+ <span class="c">/* ドライブ0,1にワーク エリアを与える */</span>
f_mount(&fs[0], "0:", 0);
f_mount(&fs[1], "1:", 0);
- <span class="c">/* hCu1̃Rs[t@CJ */</span>
+ <span class="c">/* ドライブ1のコピー元ファイルを開く */</span>
res = f_open(&fsrc, "1:file.dat", FA_OPEN_EXISTING | FA_READ);
if (fr) return (int)fr;
- <span class="c">/* hCu0ɃRs[t@C쐬 */</span>
+ <span class="c">/* ドライブ0にコピー先ファイルを作成する */</span>
res = f_open(&fdst, "0:file.dat", FA_CREATE_ALWAYS | FA_WRITE);
if (fr) return (int)fr;
- <span class="c">/* Rs[Rs[Ƀf[^] */</span>
+ <span class="c">/* コピー元からコピー先にデータ転送する */</span>
for (;;) {
- res = f_read(&fsrc, buffer, sizeof buffer, &br); <span class="c">/* Rs[炩ǂݏo */</span>
- if (res || br == 0) break; <span class="c">/* G[t@CI[ */</span>
- res = f_write(&fdst, buffer, br, &bw); <span class="c">/* Rs[ɏ */</span>
- if (res || bw < br) break; <span class="c">/* G[fBXNt */</span>
+ res = f_read(&fsrc, buffer, sizeof buffer, &br); <span class="c">/* コピー元からから読み出す */</span>
+ if (res || br == 0) break; <span class="c">/* エラーかファイル終端 */</span>
+ res = f_write(&fdst, buffer, br, &bw); <span class="c">/* それをコピー先に書き込む */</span>
+ if (res || bw < br) break; <span class="c">/* エラーかディスク満杯 */</span>
}
- <span class="c">/* SẴt@C */</span>
+ <span class="c">/* 全てのファイルを閉じる */</span>
f_close(&fsrc);
f_close(&fdst);
- <span class="c">/* [NEGAJ */</span>
+ <span class="c">/* ワーク エリアを開放する */</span>
f_mount(NULL, "0:", 0);
f_mount(NULL, "1:", 0);
@@ -162,10 +162,10 @@ int main (void) <div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="read.html">f_read</a>, <a href="write.html">f_write</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a>, <a href="sfatfs.html">FATFS</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/opendir.html b/fatfs/doc/ja/opendir.html index 9309160..ae40984 100644 --- a/fatfs/doc/ja/opendir.html +++ b/fatfs/doc/ja/opendir.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/opendir.html">
@@ -13,28 +13,28 @@ <div class="para func">
<h2>f_opendir</h2>
-<p>fBNgJ܂B</p>
+<p>ディレクトリを開きます。</p>
<pre>
FRESULT f_opendir (
- DIR* <span class="arg">dp</span>, <span class="c">/* [OUT] fBNgEuWFNg\̂ւ̃|C^ */</span>
- const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] fBNgւ̃|C^ */</span>
+ DIR* <span class="arg">dp</span>, <span class="c">/* [OUT] ディレクトリ ブジェクト構造体へのポインタ */</span>
+ const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] ディレクトリ名へのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>dp</dt>
-<dd>̃fBNgEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>空のディレクトリ オブジェクト構造体へのポインタを指定します。</dd>
<dt>path</dt>
-<dd>I[vfBNg<a href="filename.html">pX</a>k<tt>'\0'</tt>I[̕ւ̃|C^w肵܂B</dd>
+<dd>オープンするディレクトリの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -55,22 +55,22 @@ FRESULT f_opendir ( <div class="para desc">
-<h4></h4>
-<p>fBNgJ܂BIA쐬ꂽ<tt>DIR</tt>\̂gẴfBNg̍ڂǂݏo܂B</p>
+<h4>解説</h4>
+<p>ディレクトリを開きます。正常終了したら、作成された<tt>DIR</tt>構造体を使ってこのディレクトリの項目を順次読み出せます。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_MINIMIZE <= 1</tt>̂Ƃgp\ɂȂ܂B</p>
+<h4>対応情報</h4>
+<p><tt>_FS_MINIMIZE <= 1</tt>のとき使用可能になります。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="readdir.html">f_readdir</a>, <a href="closedir.html">f_closedir</a>, <a href="sdir.html">DIR</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/printf.html b/fatfs/doc/ja/printf.html index b5c22e0..4de1da2 100644 --- a/fatfs/doc/ja/printf.html +++ b/fatfs/doc/ja/printf.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/printf.html">
@@ -13,56 +13,56 @@ <div class="para func">
<h2>f_printf</h2>
-<p>t@Cɏ݂܂B</p>
+<p>ファイルに書式化文字列を書き込みます。</p>
<pre>
int f_printf (
- FIL* <span class="arg">fp</span>, <span class="c">/* [IN] t@CEIuWFNg */</span>
- const TCHAR* <span class="arg">fmt</span>, <span class="c">/* [IN] 䕶 */</span>
+ FIL* <span class="arg">fp</span>, <span class="c">/* [IN] ファイル オブジェクト */</span>
+ const TCHAR* <span class="arg">fmt</span>, <span class="c">/* [IN] 書式制御文字列 */</span>
...
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
<dt>fmt</dt>
-<dd>k<tt>'\0'</tt>I[̏䕶w|C^w肵܂Bk͏܂܂B</dd>
+<dd>ヌル文字<tt>'\0'</tt>終端の書式制御文字列を指すポインタを指定します。ヌル文字は書き込まれません。</dd>
<dt>...</dt>
-<dd>IvV̈B</dd>
+<dd>オプションの引数。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
-<p>ɏ܂ƁA܂ꂽԂ܂BfBXNt܂͂̑G[ɂ萳ɏ܂ȂƂ́A͎s<tt>EOF (-1)</tt>Ԃ܂B</p>
+<h4>戻り値</h4>
+<p>文字列が正常に書き込まれると、書き込まれた文字数が返されます。ディスクが満杯またはその他エラーにより正常に書き込まれなかったときは、関数は失敗し<tt>EOF (-1)</tt>が返されます。</p>
</div>
<div class="para desc">
-<h4></h4>
-<p>̊́A<a href="putc.html"><tt>f_putc()</tt></a><a href="puts.html"><tt>f_puts()</tt></a>̃bp[łB@\CWCũTuZbgƂȂĂāA䕶͎Ɏ̂gp\łB</p>
+<h4>解説</h4>
+<p>この関数は、<a href="putc.html"><tt>f_putc()</tt></a>および<a href="puts.html"><tt>f_puts()</tt></a>のラッパー関数です。書式制御機能はC標準ライブラリのサブセットとなっていて、書式制御文字は次に示すものが使用可能です。</p>
<ul>
-<li>^Cv: <tt>c C s S d D u U x X b B</tt></li>
-<li>xw: <tt>l L</tt></li>
-<li>tO: <tt>0 -</tt></li>
+<li>タイプ: <tt>c C s S d D u U x X b B</tt></li>
+<li>精度指定: <tt>l L</tt></li>
+<li>フラグ: <tt>0 -</tt></li>
</ul>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_USE_STRFUNC</tt>1܂2̂Ƃgp\ɂȂ܂B2̎́Ao͂Ɋ܂܂<tt>'\n'</tt><tt>'\r'+'\n'</tt>ɓWJăt@Cɏ܂܂B</p>
-<p>APIUnicodeI(<tt>_LFN_UNICODE</tt>1)ĂƂ́A<tt class="arg">fmt</tt>UnicodeɂȂ܂At@C̃GR[h́A<tt>_STRF_ENCODE</tt>IvVőIł܂BȊO͖̎ϊ(1oCg/1)ŏ݂܂B</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_STRFUNC</tt>が1または2のとき使用可能になります。2の時は、出力に含まれる<tt>'\n'</tt>が<tt>'\r'+'\n'</tt>に展開されてファイルに書き込まれます。</p>
+<p>APIにUnicodeが選択(<tt>_LFN_UNICODE</tt>が1)されているときは、<tt class="arg">fmt</tt>はUnicode文字列になりますが、ファイル上のエンコードは、<tt>_STRF_ENCODE</tt>オプションで選択できます。それ以外の時は無変換(1バイト/1文字)で書き込みます。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
f_printf(&fil, "%d", 1234); <span class="c">/* "1234" */</span>
f_printf(&fil, "%6d,%3d%%", -200, 5); <span class="c">/* " -200, 5%" */</span>
@@ -78,16 +78,16 @@ int f_printf ( f_printf(&fil, "%8s", "abc"); <span class="c">/* " abc" */</span>
f_printf(&fil, "%-8s", "abc"); <span class="c">/* "abc " */</span>
f_printf(&fil, "%c", 'a'); <span class="c">/* "a" */</span>
- f_printf(&fil, "%f", 10.0); <span class="c">/* _͖T|[g */</span>
+ f_printf(&fil, "%f", 10.0); <span class="c">/* 浮動小数点は未サポート */</span>
</pre>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="putc.html">f_putc</a>, <a href="puts.html">f_puts</a>, <a href="gets.html">f_gets</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/putc.html b/fatfs/doc/ja/putc.html index 724f4c2..6b80b1a 100644 --- a/fatfs/doc/ja/putc.html +++ b/fatfs/doc/ja/putc.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/putc.html">
@@ -13,50 +13,50 @@ <div class="para func">
<h2>f_putc</h2>
-<p>t@Cɕ݂܂B</p>
+<p>ファイルに文字を書き込みます。</p>
<pre>
int f_putc (
- TCHAR <span class="arg">chr</span>, <span class="c">/* [IN] ޕ */</span>
- FIL* <span class="arg">fp</span> <span class="c">/* [IN] t@CEIuWFNg */</span>
+ TCHAR <span class="arg">chr</span>, <span class="c">/* [IN] 書き込む文字 */</span>
+ FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>chr</dt>
-<dd>ޕw肵܂B</dd>
+<dd>書き込む文字を指定します。</dd>
<dt>fp</dt>
-<dd>t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
-<p>ɏ܂ƏԂ܂BfBXNt܂̓G[ɂ菑܂ȂƂ<tt>EOF (-1)</tt>Ԃ܂B</p>
-<p>APIUnicodeI(<tt>_LFN_UNICODE</tt>1)ĂƂ́A<tt class="arg">chr</tt>UTF-16ɂȂ܂At@C̃GR[h́A<tt>_STRF_ENCODE</tt>IvVőIł܂BȊO͖̎ϊ(1oCg/1)ŏ݂܂B</p>
+<h4>戻り値</h4>
+<p>文字が正常に書き込まれると書き込んだ文字数が返されます。ディスクが満杯またはエラーにより書き込まれなかったときは<tt>EOF (-1)</tt>が返されます。</p>
+<p>APIにUnicodeが選択(<tt>_LFN_UNICODE</tt>が1)されているときは、<tt class="arg">chr</tt>はUTF-16文字になりますが、ファイル上のエンコードは、<tt>_STRF_ENCODE</tt>オプションで選択できます。それ以外の時は無変換(1バイト/1文字)で書き込みます。</p>
</div>
<div class="para desc">
-<h4></h4>
-<p>1t@Cɏ݂܂B̊<a href="write.html"><tt>f_write()</tt></a>̃bp[łB</p>
+<h4>解説</h4>
+<p>1文字をファイルに書き込みます。この関数は<a href="write.html"><tt>f_write()</tt></a>のラッパー関数です。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_USE_STRFUNC</tt> 1܂ 2̂Ƃgp\łB2w肷ƁA<tt>'\n'</tt><tt>'\r'+'\n'</tt>ɓWJăt@Cɏ܂܂B</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_STRFUNC</tt>が 1または 2のとき使用可能です。2を指定すると、<tt>'\n'</tt>は<tt>'\r'+'\n'</tt>に展開されてファイルに書き込まれます。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="puts.html">f_puts</a>, <a href="printf.html">f_printf</a>, <a href="gets.html">f_gets</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/puts.html b/fatfs/doc/ja/puts.html index d815311..4f3167c 100644 --- a/fatfs/doc/ja/puts.html +++ b/fatfs/doc/ja/puts.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/puts.html">
@@ -13,50 +13,50 @@ <div class="para func">
<h2>f_puts</h2>
-<p>t@Cɕ݂܂B</p>
+<p>ファイルに文字列を書き込みます。</p>
<pre>
int f_puts (
- const TCHAR* <span class="arg">str</span>, <span class="c">/* [IN] ޕ */</span>
- FIL* <span class="arg">fp</span> <span class="c">/* [IN] t@CEIuWFNg */</span>
+ const TCHAR* <span class="arg">str</span>, <span class="c">/* [IN] 書き込む文字列 */</span>
+ FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>str</dt>
-<dd>ރk<tt>'\0'</tt>I[̕w|C^w肵܂Bk͏܂܂B</dd>
+<dd>書き込むヌル文字<tt>'\0'</tt>終端の文字列を指すポインタを指定します。ヌル文字は書き込まれません。</dd>
<dt>fp</dt>
-<dd>t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
-<p>ɏ܂ƁA܂ꂽԂ܂BfBXNt܂̓G[ɂ菑݂fꂽƂ<tt>EOF (-1)</tt>Ԃ܂B</p>
-<p>APIUnicodeI(<tt>_LFN_UNICODE</tt>1)ĂƂ́A<tt class="arg">str</tt>UTF-16ɂȂ܂At@C̃GR[h́A<tt>_STRF_ENCODE</tt>IvVőIł܂BȊO͖̎ϊ(1oCg/1)ŏ݂܂B</p>
+<h4>戻り値</h4>
+<p>文字列が正常に書き込まれると、書き込まれた文字数が返されます。ディスクが満杯またはエラーにより書き込みが中断されたときは<tt>EOF (-1)</tt>が返されます。</p>
+<p>APIにUnicodeが選択(<tt>_LFN_UNICODE</tt>が1)されているときは、<tt class="arg">str</tt>はUTF-16文字列になりますが、ファイル上のエンコードは、<tt>_STRF_ENCODE</tt>オプションで選択できます。それ以外の時は無変換(1バイト/1文字)で書き込みます。</p>
</div>
<div class="para desc">
-<h4></h4>
-<p>t@Cɏ݂܂B̊<a href="write.html"><tt>f_write()</tt></a>̃bp[łB</p>
+<h4>解説</h4>
+<p>文字列をファイルに書き込みます。この関数は<a href="write.html"><tt>f_write()</tt></a>のラッパー関数です。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_USE_STRFUNC</tt>1܂2̂Ƃgp\łB2w肷ƁAɊ܂܂<tt>'\n'</tt><tt>'\r'+'\n'<tt>ɓWJăt@Cɏ܂܂B</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_STRFUNC</tt>が1または2のとき使用可能です。2を指定すると、文字列に含まれる<tt>'\n'</tt>は<tt>'\r'+'\n'<tt>に展開されてファイルに書き込まれます。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="putc.html">f_putc</a>, <a href="printf.html">f_printf</a>, <a href="gets.html">f_gets</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/rc.html b/fatfs/doc/ja/rc.html index 8bcfb24..45a4738 100644 --- a/fatfs/doc/ja/rc.html +++ b/fatfs/doc/ja/rc.html @@ -11,20 +11,20 @@ <body>
<h1>ファイル関数の戻り値</h1>
-<p>FatFsのAPIでは、一部の関数を除き結果に応じた共通のリザルト・コード(FRESULT型(enum))を返します。関数が成功した場合は0を返します。失敗した場合は0以外の値を返し、値はエラーの種類を示します。</p>
+<p>FatFsのAPIでは、一部の関数を除き結果に応じた共通のリザルト コード(FRESULT型(enum))を返します。関数が成功した場合は0を返します。失敗した場合は0以外の値を返し、値はエラーの種類を示します。</p>
<dl class="ret">
<dt id="ok">FR_OK (0)</dt>
<dd>関数は成功した。</dd>
<dt id="de">FR_DISK_ERR</dt>
-<dd>下位レイヤ(<tt>disk_read(), disk_write(), disk_ioctl()</tt>関数)で回復不能なエラーが発生した。<br>※開かれたファイルの操作においてこのエラーが発生すると、そのファイル・オブジェクトはアボート状態となり、クローズ以外のの操作ができなくなります。</dd>
+<dd>下位レイヤ(<tt>disk_read(), disk_write(), disk_ioctl()</tt>関数)で回復不能なエラーが発生した。<br>※開かれたファイルの操作においてこのエラーが発生すると、そのファイル オブジェクトはアボート状態となり、クローズ以外のの操作ができなくなります。</dd>
<dt id="ie">FR_INT_ERR</dt>
<dd>内部処理の健全性に異常が検出された。原因としては次のようなことが考えられます。
<ul>
<li>ボリューム上のFAT構造にエラーがある。</li>
-<li>スタック不足や不正なメモリ操作等によるワーク・エリアの破壊。多くはこれが原因。</li>
+<li>スタック不足や不正なメモリ操作等によるワーク エリアの破壊。多くはこれが原因。</li>
</ul>
-※開かれたファイルの操作においてこのエラーが発生すると、そのファイル・オブジェクトはアボート状態となり、クローズ以外の操作ができなくなります。</dd>
+※開かれたファイルの操作においてこのエラーが発生すると、そのファイル オブジェクトはアボート状態となり、クローズ以外の操作ができなくなります。</dd>
<dt id="nr">FR_NOT_READY</dt>
<dd>物理ドライブが動作可能な状態にない。または、ドライブの初期化に失敗した。</dd>
<dt id="nf">FR_NO_FILE</dt>
@@ -38,22 +38,22 @@ <ul>
<li>書き込み禁止属性(<tt>AM_RDO</tt>)を持つファイルを書き込みモードで開こうとした。</li>
<li>書き込み禁止属性を持つファイルやディレクトリを削除しようとした。</li>
-<li>空でないディレクトリまたはカレント・ディレクトリを削除しようとした。</li>
+<li>空でないディレクトリまたはカレント ディレクトリを削除しようとした。</li>
<li><tt>FA_READ</tt>フラグを付けずに開いたファイルに対して読み出しを行った。</li>
<li><tt>FA_WRITE</tt>フラグを付けずに開いたファイルに対して書き込みまたはそれに類する操作を行った。</li>
-<li>ボリュームまたはディレクトリ・テーブルが満杯でファイルやディレクトリを作成できなかった。</li>
+<li>ボリュームまたはディレクトリ テーブルが満杯でファイルやディレクトリを作成できなかった。</li>
</ul>
</dd>
<dt id="ex">FR_EXIST</dt>
<dd>新しく作成しようとしたオブジェクトと同じ名前のオブジェクトが既に存在する。</dd>
<dt id="io">FR_INVALID_OBJECT</dt>
-<dd>指定されたファイル・オブジェクトやディレクトリ・オブジェクトが無効(オープンされていない、既に閉じられた、破損しているなど)、またはヌル・ポインタが渡された。また、開かれたままのオブジェクトは、それの属するボリュームのマウント動作により無効となります。</dd>
+<dd>指定されたファイル オブジェクトやディレクトリ オブジェクトが無効(オープンされていない、既に閉じられた、破損しているなど)、またはヌル ポインタが渡された。また、開かれたままのオブジェクトは、それの属するボリュームのマウント動作により無効となります。</dd>
<dt id="wp">FR_WRITE_PROTECTED</dt>
<dd>物理ドライブが書き込み禁止状態のとき、書き込みを伴う操作を行おうとした。</dd>
<dt id="id">FR_INVALID_DRIVE</dt>
-<dd>パス名中に指定されたドライブ番号が無効、またはパス名にヌル・ポインタが渡された。(関連オプション: <tt>_VOLUMES</tt>)</dd>
+<dd>パス名中に指定されたドライブ番号が無効、またはパス名にヌル ポインタが渡された。(関連オプション: <tt>_VOLUMES</tt>)</dd>
<dt id="ne">FR_NOT_ENABLED</dt>
-<dd>そのボリュームの操作に必要なワーク・エリア(ファイル・システム・オブジェクト構造体)が与えられていない。</dd>
+<dd>そのボリュームの操作に必要なワーク エリア(ファイル システム オブジェクト構造体)が与えられていない。</dd>
<dt id="ns">FR_NO_FILESYSTEM</dt>
<dd>物理ドライブ上に有効なFATボリュームが見つからなかった。</dd>
<dt id="ma">FR_MKFS_ABORTED</dt>
diff --git a/fatfs/doc/ja/read.html b/fatfs/doc/ja/read.html index 04ef8b3..c7f2d25 100644 --- a/fatfs/doc/ja/read.html +++ b/fatfs/doc/ja/read.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/read.html">
@@ -13,34 +13,34 @@ <div class="para func">
<h2>f_read</h2>
-<p>t@Cf[^ǂݏo܂B</p>
+<p>ファイルからデータを読み出します。</p>
<pre>
FRESULT f_read (
- FIL* <span class="arg">fp</span>, <span class="c">/* [IN] t@CEIuWFNg\ */</span>
- void* <span class="arg">buff</span>, <span class="c">/* [OUT] ǂݏof[^i[obt@ */</span>
- UINT <span class="arg">btr</span>, <span class="c">/* [IN] ǂݏooCg */</span>
- UINT* <span class="arg">br</span> <span class="c">/* [OUT] ǂݏoꂽoCg */</span>
+ FIL* <span class="arg">fp</span>, <span class="c">/* [IN] ファイル オブジェクト構造体 */</span>
+ void* <span class="arg">buff</span>, <span class="c">/* [OUT] 読み出したデータを格納するバッファ */</span>
+ UINT <span class="arg">btr</span>, <span class="c">/* [IN] 読み出すバイト数 */</span>
+ UINT* <span class="arg">br</span> <span class="c">/* [OUT] 読み出されたバイト数 */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
<dt>buff</dt>
-<dd>ǂݏof[^i[obt@w|C^w肵܂B</dd>
+<dd>読み出したデータを格納するバッファを指すポインタを指定します。</dd>
<dt>btr</dt>
-<dd>ǂݏooCg(0`<tt>UINT</tt>^̍ől)w肵܂B</dd>
+<dd>読み出すバイト数(0～<tt>UINT</tt>型の最大値)を指定します。</dd>
<dt>br</dt>
-<dd>ۂɓǂݏoꂽoCgi[ϐw|C^w肵܂B߂l͊̐ۂɂ炸ɗLłB</dd>
+<dd>実際に読み出されたバイト数を格納する変数を指すポインタを指定します。戻り値は関数の成否にかかわらず常に有効です。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -54,22 +54,22 @@ FRESULT f_read ( <div class="para desc">
-<h4></h4>
-<p>ǂݍ݊JnʒúÃ݂[h/CgE|C^ɂȂ܂B[h/CgE|C^͓ǂݍ܂ꂽoCgi݂܂BÍA<tt class="arg">*br</tt>̒l`FbNׂłB<tt class="arg">*br</tt><tt class="arg">btr</tt>Ƃ́AǂݍݒɃt@C̏I[ɒBƂĂ܂B</p>
+<h4>解説</h4>
+<p>読み込み開始位置は、現在のリード/ライト ポインタからになります。リード/ライト ポインタは読み込まれたバイト数だけ進みます。関数が正常終了した後は、<tt class="arg">*br</tt>の値をチェックすべきです。<tt class="arg">*br</tt>が<tt class="arg">btr</tt>よりも小さいときは、読み込み中にファイルの終端に達したことを示しています。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p>SĂ̍\Ŏgp\łB</p>
+<h4>対応情報</h4>
+<p>全ての構成で使用可能です。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="gets.html">fgets</a>, <a href="write.html">f_write</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/readdir.html b/fatfs/doc/ja/readdir.html index bd1c34e..fc8fc5c 100644 --- a/fatfs/doc/ja/readdir.html +++ b/fatfs/doc/ja/readdir.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/readdir.html">
@@ -13,28 +13,28 @@ <div class="para func">
<h2>f_readdir</h2>
-<p>fBNgڂǂݏo܂B</p>
+<p>ディレクトリ項目を読み出します。</p>
<pre>
FRESULT f_readdir (
- DIR* <span class="arg">dp</span>, <span class="c">/* [IN] fBNgEuWFNg\̂ւ̃|C^ */</span>
- FILINFO* <span class="arg">fno</span> <span class="c">/* [OUT] t@C\̂ւ̃|C^ */</span>
+ DIR* <span class="arg">dp</span>, <span class="c">/* [IN] ディレクトリ ブジェクト構造体へのポインタ */</span>
+ FILINFO* <span class="arg">fno</span> <span class="c">/* [OUT] ファイル情報構造体へのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>dp</dt>
-<dd>LȃfBNgEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>有効なディレクトリ オブジェクト構造体へのポインタを指定します。</dd>
<dt>fno</dt>
-<dd>ǂݏofBNgڂi[t@C\̂ւ̃|C^w肵܂B</dd>
+<dd>読み出したディレクトリ項目を格納するファイル情報構造体へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -48,37 +48,37 @@ FRESULT f_readdir ( <div class="para desc">
-<h4></h4>
-<p>fBNg̍(t@CƃfBNg)ǂݏo܂B̊JԂs邱Ƃɂ肻̃fBNg̑SĂ̍ڂǂݏoƂł܂Bt@C̏ڍׂɂĂ <tt>FILINFO</tt>\̂QƂĂBSĂ̍ڂǂݏoAǂݏoڂƂ́A<tt>fname[]</tt>oɃkԂ܂B<tt class="arg">fno</tt>ɃkE|C^w肷ƁÃfBNg̃[hECfbNX擪Ɋ߂܂B܂Å͎Ɏ悤Ɋ֘A\IvVɂ蓮삪ς܂B</p>
-<p>hbgEGg("."A"..")́ApXLȂƂ(<tt>_FS_RPATH >= 1</tt>)ɂ̂ݏo͂Ɍ܂B</p>
-<p>LFN@\LȎ́Å̌Ăяoɐ旧<tt>FILINFO</tt>\̂<tt>lfname</tt><tt>lfsize</tt>LȒlŏĂȂȂ܂B<tt>lfname</tt>LFNi[obt@ŁA<tt>lfsize</tt>͂̃obt@̗vfłBLFNǂݏoKvȂƂ́A<tt>lfname</tt>ɃkE|C^ZbgĂB̏ɈłYꍇ́ALFNi[obt@ɃkԂ܂B</p>
+<h4>解説</h4>
+<p>ディレクトリの項目(ファイルとディレクトリ)を順次読み出します。この関数を繰り返し実行することによりそのディレクトリの全ての項目を読み出すことができます。得られるファイル情報の詳細については <tt>FILINFO</tt>構造体を参照してください。全ての項目が読み出され、読み出す項目がもう無いときは、<tt>fname[]</tt>メンバにヌル文字列が返されます。<tt class="arg">fno</tt>にヌル ポインタを指定すると、そのディレクトリのリード インデックスを先頭に巻き戻します。また、この関数は次に示すように関連する構成オプションにより動作が変わります。</p>
+<p>ドット エントリ("."、"..")は、相対パスが有効なとき(<tt>_FS_RPATH >= 1</tt>)にのみ出力に現れます。</p>
+<p>LFN機能が有効な時は、この関数の呼び出しに先立って<tt>FILINFO</tt>構造体の<tt>lfname</tt>と<tt>lfsize</tt>が有効な値で初期化されていなければなりません。<tt>lfname</tt>はLFNを格納するバッファで、<tt>lfsize</tt>はそのバッファの要素数です。LFNを読み出す必要がないときは、<tt>lfname</tt>にヌル ポインタをセットしてください。次の条件に一つでも該当する場合は、LFN格納バッファにヌル文字列が返されます。</p>
<ul>
-<li>fBNgڂLFN݂ȂB</li>
-<li>LFN̒ɑLFNi[obt@܂LFNobt@̃TCYs\B</li>
-<li>LFNɌ݂OEMR[hɑ݂Ȃ܂܂ĂB(Unicode\̂Ƃ)</li>
+<li>ディレクトリ項目にLFN情報が存在しない。</li>
+<li>LFNの長さに対してLFN格納バッファまたはLFN操作バッファのサイズが不十分。</li>
+<li>LFNに現在のOEMコードに存在しない文字が含まれている。(非Unicode構成のとき)</li>
</ul>
-<p>܂AfBNgڂLFN݂Ȃꍇ́A<tt>fname[]</tt>ɉp܂܂ꍇ܂B</p>
+<p>また、ディレクトリ項目にLFN情報が存在しない場合は、<tt>fname[]</tt>に英小文字が含まれる場合があります。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_MINIMIZE <= 1</tt>̂ƂɎgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_MINIMIZE <= 1</tt>のときに使用可能です。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
FRESULT scan_files (
- char* path <span class="c">/* Jnm[h ([NGAƂĂgp) */</span>
+ char* path <span class="c">/* 開始ノード (ワークエリアとしても使用) */</span>
)
{
FRESULT res;
FILINFO fno;
DIR dir;
int i;
- char *fn; <span class="c">/* Unicode\z */</span>
+ char *fn; <span class="c">/* 非Unicode構成を想定 */</span>
<span class="k">#if</span> _USE_LFN
static char lfn[_MAX_LFN + 1];
fno.lfname = lfn;
@@ -86,24 +86,24 @@ FRESULT scan_files ( <span class="k">#endif</span>
- res = f_opendir(&dir, path); <span class="c">/* fBNgJ */</span>
+ res = f_opendir(&dir, path); <span class="c">/* ディレクトリを開く */</span>
if (res == FR_OK) {
i = strlen(path);
for (;;) {
- res = f_readdir(&dir, &fno); <span class="c">/* fBNgڂ1ǂݏo */</span>
- if (res != FR_OK || fno.fname[0] == 0) break; <span class="c">/* G[܂͍ږ̂Ƃ͔ */</span>
- if (fno.fname[0] == '.') continue; <span class="c">/* hbgGg͖ */</span>
+ res = f_readdir(&dir, &fno); <span class="c">/* ディレクトリ項目を1個読み出す */</span>
+ if (res != FR_OK || fno.fname[0] == 0) break; <span class="c">/* エラーまたは項目無しのときは抜ける */</span>
+ if (fno.fname[0] == '.') continue; <span class="c">/* ドットエントリは無視 */</span>
<span class="k">#if</span> _USE_LFN
fn = *fno.lfname ? fno.lfname : fno.fname;
<span class="k">#else</span>
fn = fno.fname;
<span class="k">#endif</span>
- if (fno.fattrib & AM_DIR) { <span class="c">/* fBNg */</span>
+ if (fno.fattrib & AM_DIR) { <span class="c">/* ディレクトリ */</span>
sprintf(&path[i], "/%s", fn);
res = scan_files(path);
- if (res != FR_OK) break;
path[i] = 0;
- } else { <span class="c">/* t@C */</span>
+ if (res != FR_OK) break;
+ } else { <span class="c">/* ファイル */</span>
printf("%s/%s\n", path, fn);
}
}
@@ -117,10 +117,10 @@ FRESULT scan_files ( <div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="opendir.html">f_opendir</a>, <a href="closedir.html">f_closedir</a>, <a href="stat.html">f_stat</a>, <a href="sfileinfo.html">FILINFO</a>, <a href="sdir.html">DIR</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/rename.html b/fatfs/doc/ja/rename.html index 0eafa49..5259846 100644 --- a/fatfs/doc/ja/rename.html +++ b/fatfs/doc/ja/rename.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/rename.html">
@@ -13,28 +13,28 @@ <div class="para func">
<h2>f_rename</h2>
-<p>t@C܂̓TuEfBNg̖O̕ύX܂͈ړ܂B</p>
+<p>ファイルまたはサブ ディレクトリの名前の変更または移動します。</p>
<pre>
FRESULT f_rename (
- const TCHAR* <span class="arg">old_name</span>, <span class="c">/* [IN] ÂIuWFNg */</span>
- const TCHAR* <span class="arg">new_name</span> <span class="c">/* [IN] VIuWFNg */</span>
+ const TCHAR* <span class="arg">old_name</span>, <span class="c">/* [IN] 古いオブジェクト名 */</span>
+ const TCHAR* <span class="arg">new_name</span> <span class="c">/* [IN] 新しいオブジェクト名 */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>old_name</dt>
-<dd>ύXΏۂ̃t@C܂̓TuEfBNg<a href="filename.html">pX</a>k<tt>'\0'</tt>I[̕ւ̃|C^w肵܂B</dd>
+<dd>変更対象のファイルまたはサブ ディレクトリの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd>
<dt>new_name</dt>
-<dd>VpXk<tt>'\0'</tt>I[̕ւ̃|C^w肵܂Bɑ݂IuWFNgƓO͎g܂B܂AhCuԍ͎w肵ĂA<tt class="arg">old_name</tt>Ō߂ꂽ_hCũIuWFNgƂĈ܂B</dd>
+<dd>新しいパス名を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。既に存在するオブジェクトと同じ名前は使えません。また、ドライブ番号は指定しても無視され、<tt class="arg">old_name</tt>で決められた論理ドライブ上のオブジェクトとして扱われます。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -55,28 +55,28 @@ FRESULT f_rename ( <div class="para desc">
-<h4></h4>
-<p>t@C܂̓TuEfBNg̖OύX܂B܂Aɕʂ̃fBNgւ̈ړ\łAقȂhCuւ̈ړ͂ł܂B<em>JĂIuWFNgɑĎgpĂ͂Ȃ܂</em>B</p>
+<h4>解説</h4>
+<p>ファイルまたはサブ ディレクトリの名前を変更します。また、同時に別のディレクトリへの移動も可能ですが、異なるドライブへの移動はできません。<em>開かれているオブジェクトに対して使用してはなりません</em>。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_FS_MINIMIZE == 0</tt>̂ƂɎgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のときに使用可能です。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
- <span class="c">/* t@C܂̓TufBNg̖OύX */</span>
+ <span class="c">/* ファイルまたはサブディレクトリの名前を変更する */</span>
f_rename("oldname.txt", "newname.txt");
- <span class="c">/* t@C܂̓TufBNg̖O̕ύXƕʂ̃fBNgւ̈ړ */</span>
+ <span class="c">/* ファイルまたはサブディレクトリの名前の変更と別のディレクトリへの移動 */</span>
f_rename("oldname.txt", "dir1/newname.txt");
</pre>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/sdir.html b/fatfs/doc/ja/sdir.html index 3e6f712..3390549 100644 --- a/fatfs/doc/ja/sdir.html +++ b/fatfs/doc/ja/sdir.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/sdir.html">
@@ -13,28 +13,28 @@ <div class="para">
<h2>DIR</h2>
-<p><tt>DIR</tt>\̂́A<tt>f_opendir(), f_readdir()</tt>̃[NEGAƂĎgp܂BAvP[V́A̍\̂̃oĂ͂Ȃ܂B</p>
+<p><tt>DIR</tt>構造体は、<tt>f_opendir(), f_readdir()</tt>のワーク エリアとして使用されます。アプリケーションは、この構造体のメンバを書き換えてはなりません。</p>
<pre>
<span class="k">typedef</span> <span class="k">struct</span> {
- FATFS* fs; <span class="c">/* et@CEVXeEIuWFNgւ̃|C^ */</span>
- WORD id; <span class="c">/* et@CEVXeEIuWFNg̃}EgID */</span>
- WORD index; <span class="c">/* ɌJnfBNgECfbNXԍ */</span>
- DWORD sclust; <span class="c">/* e[uJnNX^ (0:[g) */</span>
- DWORD clust; <span class="c">/* ݂̃NX^ԍ */</span>
- DWORD sect; <span class="c">/* ݂̃ZN^ԍ */</span>
- BYTE* dir; <span class="c">/* ݂SFNGgւ̃|C^ */</span>
- BYTE* fn; <span class="c">/* SFNobt@ւ̃|C^ (in/out) {file[8],ext[3],status[1]} */</span>
+ FATFS* fs; <span class="c">/* 親ファイル システム オブジェクトへのポインタ */</span>
+ WORD id; <span class="c">/* 親ファイル システム オブジェクトのマウントID */</span>
+ WORD index; <span class="c">/* 次に検索開始するディレクトリ インデックス番号 */</span>
+ DWORD sclust; <span class="c">/* テーブル開始クラスタ (0:ルート) */</span>
+ DWORD clust; <span class="c">/* 現在のクラスタ番号 */</span>
+ DWORD sect; <span class="c">/* 現在のセクタ番号 */</span>
+ BYTE* dir; <span class="c">/* 現在のSFNエントリへのポインタ */</span>
+ BYTE* fn; <span class="c">/* SFNバッファへのポインタ (in/out) {file[8],ext[3],status[1]} */</span>
<span class="k">#if</span> _FS_LOCK
- UINT lockid; <span class="c">/* bNID */</span>
+ UINT lockid; <span class="c">/* ロックID */</span>
<span class="k">#endif</span>
<span class="k">#if</span> _USE_LFN
- WCHAR* lfn; <span class="c">/* LFNobt@ւ̃|C^ (in/out) */</span>
- WORD lfn_idx; <span class="c">/* LFNGg̐擪CfbNX (0xFFFF:) */</span>
+ WCHAR* lfn; <span class="c">/* LFNバッファへのポインタ (in/out) */</span>
+ WORD lfn_idx; <span class="c">/* LFNエントリの先頭インデックス (0xFFFF:無効) */</span>
<span class="k">#endif</span>
} DIR;
</pre>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/setlabel.html b/fatfs/doc/ja/setlabel.html index af4a243..dc71ac3 100644 --- a/fatfs/doc/ja/setlabel.html +++ b/fatfs/doc/ja/setlabel.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/setlabel.html">
@@ -13,25 +13,25 @@ <div class="para func">
<h2>f_setlabel</h2>
-<p>{[Ƀ{[Exݒ肵܂B</p>
+<p>ボリュームにボリューム ラベルを設定します。</p>
<pre>
FRESULT f_setlabel (
- const TCHAR* <span class="arg">label</span> <span class="c">/* [IN] ݒ肷{[Exւ̃|C^ */</span>
+ const TCHAR* <span class="arg">label</span> <span class="c">/* [IN] 設定するボリューム ラベルへのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>label</dt>
-<dd>ݒ肷{[Exk<tt>'\0'</tt>I[̕ւ̃|C^w肵܂B</dd>
+<dd>設定するボリューム ラベルを示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -48,42 +48,42 @@ FRESULT f_setlabel ( <div class="para desc">
-<h4></h4>
-<p>̐擪ɃhCuԍ܂ޏꍇ́A̘_hCuɑĐݒ肳܂B܂܂Ȃꍇ́AftHgEhCuɐݒ肳܂B{[Ex폜Ƃ́Akw肵܂B{[Ex̃tH[}bǵAt@C(SFN)ƂقړłA̓_قȂ܂B</p>
+<h4>解説</h4>
+<p>文字列の先頭にドライブ番号を含む場合は、その論理ドライブに対して設定されます。含まない場合は、デフォルト ドライブに設定されます。ボリューム ラベルを削除するときは、ヌル文字列を指定します。ボリューム ラベルのフォーマットは、ファイル名(SFN)とほぼ同じですが、次の点が異なります。</p>
<ul>
-<li>[JR[hZ11oCgȉBLFNg͓Kp܂B</li>
-<li>sIh܂ނƂ͂łȂB</li>
-<li>Cӂ̈ʒuɃXy[XuƂłBAŌƂȂXy[X͏B</li>
+<li>ローカル文字コード換算で11バイト以下。LFN拡張は適用されません。</li>
+<li>ピリオドを含むことはできない。</li>
+<li>任意の位置にスペースを置くことができる。ただし、最後尾となるスペースは除去される。</li>
</ul>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_USE_LABEL == 1</tt>̂ƂɎgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_LABEL == 1</tt>のときに使用可能です。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
- <span class="c">/* ftHgEhCuɃ{[Exݒ */</span>
+ <span class="c">/* デフォルト ドライブにボリューム ラベルを設定 */</span>
f_setlabel("DATA DISK");
- <span class="c">/* hCu2Ƀ{[Exݒ */</span>
+ <span class="c">/* ドライブ2にボリューム ラベルを設定 */</span>
f_setlabel("2:DISK 3 OF 4");
- <span class="c">/* hCu2̃{[Ex폜 */</span>
+ <span class="c">/* ドライブ2のボリューム ラベルを削除 */</span>
f_setlabel("2:");
</pre>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<tt><a href="getlabel.html">f_getlabel</a></tt>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/sfatfs.html b/fatfs/doc/ja/sfatfs.html index ed5ac87..93b9e7c 100644 --- a/fatfs/doc/ja/sfatfs.html +++ b/fatfs/doc/ja/sfatfs.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/sfatfs.html">
@@ -13,43 +13,43 @@ <div class="para">
<h2>FATFS</h2>
-<p><tt>FATFS</tt>\(t@CEVXeEIuWFNg)́AX̘_hCũ_Ci~bNE[NEGAێA<tt>f_mount()</tt>FatFsW[ɓo^܂Bs^C~ÓA<tt>f_mount()</tt>(}Egw)̎s܂̓fBǍ̍ŏ̃t@CEANZX̎łBAvP[V́A̍\̂̃oĂ͂Ȃ܂B</p>
+<p><tt>FATFS</tt>構造体(ファイル システム オブジェクト)は、個々の論理ドライブのダイナミック ワーク エリアを保持し、<tt>f_mount()</tt>でFatFsモジュールに登録されます。初期化が行われるタイミングは、<tt>f_mount()</tt>(強制マウント指定)の実行またはメディア交換の後の最初のファイル アクセスの時です。アプリケーションは、この構造体のメンバを書き換えてはなりません。</p>
<pre>
<span class="k">typedef</span> <span class="k">struct</span> {
- BYTE fs_type; <span class="c">/* FAT^Cv */</span>
- BYTE drv; <span class="c">/* hCuԍ */</span>
- BYTE csize; <span class="c">/* NX^̃ZN^ (1,2,4,8,...,128)*/</span>
- BYTE n_fats; <span class="c">/* FAT̑d (1,2) */</span>
- BYTE wflag; <span class="c">/* win[]_[eBEtO */</span>
- BYTE fsi_flag; <span class="c">/* FSINFOtO (b7:Disabled, b0:Dirty)*/</span>
- WORD id; <span class="c">/* t@CEVXeE}EgID */</span>
- WORD n_rootdir; <span class="c">/* [gEfBNg̃Gg (FAT12/16) */</span>
+ BYTE fs_type; <span class="c">/* FATタイプ */</span>
+ BYTE drv; <span class="c">/* 物理ドライブ番号 */</span>
+ BYTE csize; <span class="c">/* クラスタ当たりのセクタ数 (1,2,4,8,...,128)*/</span>
+ BYTE n_fats; <span class="c">/* FATの多重化数 (1,2) */</span>
+ BYTE wflag; <span class="c">/* win[]ダーティ フラグ */</span>
+ BYTE fsi_flag; <span class="c">/* FSINFOフラグ (b7:Disabled, b0:Dirty)*/</span>
+ WORD id; <span class="c">/* ファイル システム マウントID */</span>
+ WORD n_rootdir; <span class="c">/* ルート ディレクトリのエントリ数 (FAT12/16) */</span>
<span class="k">#if</span> _MAX_SS != _MIN_SS
- WORD ssize; <span class="c">/* ZN^ETCY (512, 1024, 2048 or 4096) */</span>
+ WORD ssize; <span class="c">/* セクタ サイズ (512, 1024, 2048 or 4096) */</span>
<span class="k">#endif</span>
<span class="k">#if</span> _FS_REENTRANT
- _SYNC_t sobj; <span class="c">/* IuWFNgID */</span>
+ _SYNC_t sobj; <span class="c">/* 同期オブジェクトID */</span>
<span class="k">#endif</span>
<span class="k">#if</span> !_FS_READONLY
- DWORD last_clust; <span class="c">/* FSINFO: ŌɊ蓖ĂꂽNX^ԍ */</span>
- DWORD free_clust; <span class="c">/* FSINFO: NX^ */</span>
+ DWORD last_clust; <span class="c">/* FSINFO: 最後に割り当てられたクラスタ番号 */</span>
+ DWORD free_clust; <span class="c">/* FSINFO: 空きクラスタ数 */</span>
<span class="k">#endif</span>
<span class="k">#if</span> _FS_RPATH
- DWORD cdir; <span class="c">/* JgEfBNg̃NX^ (0:[g) */</span>
+ DWORD cdir; <span class="c">/* カレント ディレクトリのクラスタ (0:ルート) */</span>
<span class="k">#endif</span>
- DWORD n_fatent; <span class="c">/* FATGg (NX^ + 2) */</span>
- DWORD fsize; <span class="c">/* FAT 1̃ZN^ */</span>
- DWORD volbase; <span class="c">/* {[JnZN^ */</span>
- DWORD fatbase; <span class="c">/* FAT̈JnZN^ */</span>
- DWORD dirbase; <span class="c">/* [gEfBNg̈JnZN^(NX^) */</span>
- DWORD database; <span class="c">/* f[^̈JnZN^ */</span>
- DWORD winsect; <span class="c">/* win[]ɌĂZN^ԍ */</span>
- BYTE win[_MAX_SS]; <span class="c">/* fBXNEANZXEEBhE */</span>
+ DWORD n_fatent; <span class="c">/* FATエントリ数 (総クラスタ数 + 2) */</span>
+ DWORD fsize; <span class="c">/* FAT 1個のセクタ数 */</span>
+ DWORD volbase; <span class="c">/* ボリューム開始セクタ */</span>
+ DWORD fatbase; <span class="c">/* FAT領域開始セクタ */</span>
+ DWORD dirbase; <span class="c">/* ルート ディレクトリ領域開始セクタ(クラスタ) */</span>
+ DWORD database; <span class="c">/* データ領域開始セクタ */</span>
+ DWORD winsect; <span class="c">/* win[]に現れているセクタ番号 */</span>
+ BYTE win[_MAX_SS]; <span class="c">/* ディスク アクセス ウィンドウ */</span>
} FATFS;
</pre>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/sfile.html b/fatfs/doc/ja/sfile.html index 36a73b3..5da60f9 100644 --- a/fatfs/doc/ja/sfile.html +++ b/fatfs/doc/ja/sfile.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/sfile.html">
@@ -13,36 +13,36 @@ <div class="para">
<h2>FIL</h2>
-<p><tt>FIL</tt>\(t@CEIuWFNg)́A<tt>f_open()</tt>ŏAȌセ̃t@C̏Ԃێ܂B܂A<tt>f_close()</tt>Ńt@CƖ܂BAvP[V́A̍\̂̃oĂ͂Ȃ܂(<tt>cltbl</tt>͗O)B^Cj[\ł́AɃZN^Eobt@mۂ̂ŁALTCYɒӂKvłB</p>
+<p><tt>FIL</tt>構造体(ファイル オブジェクト)は、<tt>f_open()</tt>で初期化され、以後そのファイルの状態を保持します。また、<tt>f_close()</tt>でファイルが閉じられると無効化されます。アプリケーションは、この構造体のメンバを書き換えてはなりません(<tt>cltbl</tt>は例外)。非タイニー構成(<tt>_FS_TINY == 0</tt>)では、内部に<tt>_MAX_SS</tt>バイトのセクタ バッファが確保されるので、そのサイズには注意が必要です。</p>
<pre>
<span class="k">typedef</span> <span class="k">struct</span> {
- FATFS* fs; <span class="c">/* et@CEVXeEIuWFNgւ̃|C^ */</span>
- WORD id; <span class="c">/* et@CEVXeEIuWFNg̃}EgID */</span>
- BYTE flag; <span class="c">/* t@CEXe[^XEtO */</span>
- BYTE err; <span class="c">/* G[ftO */</span>
- DWORD fptr; <span class="c">/* t@Cǂݏ|C^ (t@C擪̃oCgEItZbg) */</span>
- DWORD fsize; <span class="c">/* t@CETCY(oCgP) */</span>
- DWORD sclust; <span class="c">/* t@CJnNX^ԍ (0:蓖Ė) */</span>
- DWORD clust; <span class="c">/* ݂̃NX^ */</span>
- DWORD dsect; <span class="c">/* ݂̃f[^EZN^ */</span>
+ FATFS* fs; <span class="c">/* 親ファイル システム オブジェクトへのポインタ */</span>
+ WORD id; <span class="c">/* 親ファイル システム オブジェクトのマウントID */</span>
+ BYTE flag; <span class="c">/* ファイル ステータス フラグ */</span>
+ BYTE err; <span class="c">/* エラー中断フラグ */</span>
+ DWORD fptr; <span class="c">/* ファイル読み書きポインタ (ファイル先頭からのバイト オフセット) */</span>
+ DWORD fsize; <span class="c">/* ファイル サイズ(バイト単位) */</span>
+ DWORD sclust; <span class="c">/* ファイル開始クラスタ番号 (0:割り当て無し) */</span>
+ DWORD clust; <span class="c">/* 現在のクラスタ */</span>
+ DWORD dsect; <span class="c">/* 現在のデータ セクタ */</span>
<span class="k">#if</span> !_FS_READONLY
- DWORD dir_sect; <span class="c">/* ̃t@C̃fBNgEGĝZN^ */</span>
- BYTE* dir_ptr; <span class="c">/* ̃t@C̃fBNgւ̃|C^ */</span>
+ DWORD dir_sect; <span class="c">/* このファイルのディレクトリ エントリのあるセクタ */</span>
+ BYTE* dir_ptr; <span class="c">/* このファイルのディレクトリへのポインタ */</span>
<span class="k">#endif</span>
<span class="k">#if</span> _USE_FASTSEEK
- DWORD* cltbl; <span class="c">/* t@C̃NX^ENւ̃|C^ (I[vNULLZbg) */</span>
+ DWORD* cltbl; <span class="c">/* ファイルのクラスタ リンク情報へのポインタ (オープン時にNULLがセットされる) */</span>
<span class="k">#endif</span>
<span class="k">#if</span> _FS_LOCK
- UINT lockid; <span class="c">/* t@CEbNID */</span>
+ UINT lockid; <span class="c">/* ファイル ロックID */</span>
<span class="k">#endif</span>
<span class="k">#if</span> !_FS_TINY
- BYTE buf[_MAX_SS]; <span class="c">/* t@CEvCx[gEf[^]obt@ */</span>
+ BYTE buf[_MAX_SS]; <span class="c">/* ファイル プライベート データ転送バッファ */</span>
<span class="k">#endif</span>
} FIL;
</pre>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/sfileinfo.html b/fatfs/doc/ja/sfileinfo.html index 1a3db24..a9167f1 100644 --- a/fatfs/doc/ja/sfileinfo.html +++ b/fatfs/doc/ja/sfileinfo.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/sfileinfo.html">
@@ -13,58 +13,58 @@ <div class="para">
<h2>FILINFO</h2>
-<p><tt>FILINFO</tt>\̂́A<tt>f_stat(), f_readdir()</tt>ŕԂt@Cێ܂B</p>
+<p><tt>FILINFO</tt>構造体は、<tt>f_stat(), f_readdir()</tt>で返されるファイル情報を保持します。</p>
<pre>
<span class="k">typedef</span> <span class="k">struct</span> {
- DWORD fsize; <span class="c">/* t@CETCY */</span>
- WORD fdate; <span class="c">/* ŌɍXVꂽt */</span>
- WORD ftime; <span class="c">/* ŌɍXVꂽ */</span>
- BYTE fattrib; <span class="c">/* Agr[g */</span>
- TCHAR fname[13]; <span class="c">/* Zt@C (8.3tH[}bg) */</span>
+ DWORD fsize; <span class="c">/* ファイル サイズ */</span>
+ WORD fdate; <span class="c">/* 最後に更新された日付 */</span>
+ WORD ftime; <span class="c">/* 最後に更新された時刻 */</span>
+ BYTE fattrib; <span class="c">/* アトリビュート */</span>
+ TCHAR fname[13]; <span class="c">/* 短いファイル名 (8.3フォーマット) */</span>
<span class="k">#if</span> _USE_LFN
- TCHAR* lfname; <span class="c">/* t@C̃obt@ւ̃|C^ */</span>
- int lfsize; <span class="c">/* t@C̃obt@̃TCY [] */</span>
+ TCHAR* lfname; <span class="c">/* 長いファイル名のバッファへのポインタ */</span>
+ int lfsize; <span class="c">/* 長いファイル名のバッファのサイズ [文字数] */</span>
<span class="k">#endif</span>
} FILINFO;
</pre>
</div>
-<h4>o</h4>
+<h4>メンバ</h4>
<dl>
<dt>fsize</dt>
-<dd>t@C̃oCgPʂ̃TCYi[܂BfBNg̏ꍇ͏0łB</dd>
+<dd>ファイルのバイト単位のサイズが格納されます。ディレクトリの場合は常に0です。</dd>
<dt>fdate</dt>
-<dd>t@C̕ύXꂽtA܂̓fBNg̍쐬ꂽti[܂B<br>
+<dd>ファイルの変更された日付、またはディレクトリの作成された日付が格納されます。<br>
<dl>
<dt>bit15:9</dt>
-<dd>1980NN_ƂN 0..127 œ܂B</dd>
+<dd>1980年を起点とした年が 0..127 で入ります。</dd>
<dt>bit8:5</dt>
-<dd> 1..12 ̒lœ܂B</dd>
+<dd>月が 1..12 の値で入ります。</dd>
<dt>bit4:0</dt>
-<dd> 1..31 ̒lœ܂B</dd>
+<dd>日が 1..31 の値で入ります。</dd>
</dl>
</dd>
<dt>ftime</dt>
-<dd>t@C̕ύXꂽA܂̓fBNg̍쐬ꂽi[܂B<br>
+<dd>ファイルの変更された時刻、またはディレクトリの作成された時刻が格納されます。<br>
<dl>
<dt>bit15:11</dt>
-<dd> 0..23 ̒lœ܂B</dd>
+<dd>時が 0..23 の値で入ります。</dd>
<dt>bit10:5</dt>
-<dd> 0..59 ̒lœ܂B</dd>
+<dd>分が 0..59 の値で入ります。</dd>
<dt>bit4:0</dt>
-<dd>b/2 0..29 ̒lœ܂B</dd>
+<dd>秒/2が 0..29 の値で入ります。</dd>
</dl>
</dd>
<dt>fattrib</dt>
-<dd>tOi[܂BtO<tt>AM_DIR, AM_RDO, AM_HID, AM_SYS, AM_ARC</tt>̑gݍ킹ƂȂ܂B</dd>
+<dd>属性フラグが格納されます。フラグは<tt>AM_DIR, AM_RDO, AM_HID, AM_SYS, AM_ARC</tt>の組み合わせとなります。</dd>
<dt>fname[]</dt>
-<dd>8.3`̖O<tt>'\0'</tt>ŏI镶ƂĊi[܂BLFN\̂Ƃ́Aɑ啶ŕԂ܂BLFN\̂Ƃ͒ZOԂ܂AASCIIpɂȂꍇ܂B</dd>
+<dd>8.3形式の名前が<tt>'\0'</tt>で終わる文字列として格納されます。非LFN構成のときは、常に大文字で返されます。LFN構成のときは短い名前が返されますが、ASCII英字が小文字になる場合があります。</dd>
<dt>lfname</dt>
-<dd>Ԃ钷t@Ci[obt@ւ̃|C^B̍\̂gpOɃAvP[Vɂ菉ȂȂ܂B̃oNULLݒ肳LFN͕Ԃ܂BLFN\̂Ƃ͂̃o݂͑܂B</dd>
+<dd>返される長いファイル名を格納するバッファへのポインタ。この構造体を使用する前にアプリケーションにより初期化されなければなりません。このメンバにNULLが設定されるとLFNは返されません。非LFN構成のときはこのメンバは存在しません。</dd>
<dt>lfsize</dt>
-<dd>t@Ci[obt@̃TCY(vf)B̍\̂gpOɃAvP[Vɂ菉ȂȂ܂BLFN\̂Ƃ͂̃o݂͑܂B</dd>
+<dd>長いファイル名を格納するバッファのサイズ(要素数)。この構造体を使用する前にアプリケーションにより初期化されなければなりません。非LFN構成のときはこのメンバは存在しません。</dd>
</dl>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/size.html b/fatfs/doc/ja/size.html index caff05d..d75ffc3 100644 --- a/fatfs/doc/ja/size.html +++ b/fatfs/doc/ja/size.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/size.html">
@@ -13,33 +13,33 @@ <div class="para func">
<h2>f_size</h2>
-<p>t@C̃TCY擾܂B</p>
+<p>ファイルのサイズを取得します。</p>
<pre>
DWORD f_size (
- FIL* <span class="arg">fp</span> <span class="c">/* [IN] t@CEIuWFNg */</span>
+ FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
-<p>oCgPʂ̃t@CETCYԂ܂B</p>
+<h4>戻り値</h4>
+<p>バイト単位のファイル サイズが返ります。</p>
</div>
<div class="para desc">
-<h4></h4>
-<p>f_sizéArWł̓}NƂĎĂ܂B</p>
+<h4>解説</h4>
+<p>f_size関数は、現リビジョンではマクロとして実装されています。</p>
<pre>
<span class="k">#define</span> f_size(fp) ((fp)->fsize)
</pre>
@@ -47,16 +47,16 @@ DWORD f_size ( <div class="para comp">
-<h4>Ή</h4>
-<p>Ɏgp\B</p>
+<h4>対応情報</h4>
+<p>常に使用可能。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="lseek.html">f_lseek</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/stat.html b/fatfs/doc/ja/stat.html index 5337f34..724a9d5 100644 --- a/fatfs/doc/ja/stat.html +++ b/fatfs/doc/ja/stat.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/stat.html">
@@ -13,28 +13,28 @@ <div class="para func">
<h2>f_stat</h2>
-<p>t@C܂̓TuEfBNgׁ݂̑A܂̏擾܂B</p>
+<p>ファイルまたはサブ ディレクトリの存在を調べ、またその情報を取得します。</p>
<pre>
FRESULT f_stat (
- const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] IuWFNgւ̃|C^ */</span>
- FILINFO* <span class="arg">fno</span> <span class="c">/* [OUT] t@C\̂ւ̃|C^ */</span>
+ const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] オブジェクト名へのポインタ */</span>
+ FILINFO* <span class="arg">fno</span> <span class="c">/* [OUT] ファイル情報構造体へのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>path</dt>
-<dd>`FbNIuWFNgk<tt>'\0'</tt>I[̕w|C^w肵܂B</dd>
+<dd>チェックするオブジェクト名を示すヌル文字<tt>'\0'</tt>終端の文字列を指すポインタを指定します。</dd>
<dt>fno</dt>
-<dd>IuWFNg݂Ƃɂ̏i[t@C\̂ւ̃|C^w肵܂B̏svȂƂ̓kE|C^w肵ĂB</dd>
+<dd>オブジェクトが存在したときにその情報を格納するファイル情報構造体へのポインタを指定します。この情報が不要なときはヌル ポインタを指定してください。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -53,22 +53,61 @@ FRESULT f_stat ( <div class="para desc">
-<h4></h4>
-<p>w肳ꂽt@C܂̓TuEfBNgׂ݂̑܂B݂Ȃꍇ́A<tt>FR_NO_FILE</tt>A܂B݂ꍇ<tt>FR_OK</tt>AAt@C\̂ɂւ(TCYA^CX^vAђZt@C)XgA܂B</p>
+<h4>解説</h4>
+<p>指定されたファイルまたはサブ ディレクトリの存在を調べます。存在しない場合は、<tt>FR_NO_FILE</tt>が帰ります。存在する場合は<tt>FR_OK</tt>が帰り、ファイル情報構造体にそれ関する情報(サイズ、タイムスタンプ、属性および短いファイル名)がストアされます。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_MINIMIZE == 0</tt>̂ƂɎgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_MINIMIZE == 0</tt>のときに使用可能です。</p>
+</div>
+
+
+<div class="para use">
+<h4>使用例</h4>
+<pre>
+ FRESULT fr;
+ FILINFO fno;
+
+
+ printf("Test for 'file.txt'...\n");
+
+<span class="k">#if</span> _USE_LFN
+ fno.lfname = 0;
+<span class="k">#endif</span>
+ fr = f_stat("file.txt", &fno);
+ switch (fr) {
+
+ case FR_OK:
+ printf("Size: %u\n", fno.fsize);
+ printf("Timestamp: %u/%02u/%02u, %02u:%02u\n",
+ (fno.fdate >> 9) + 1980, fno.fdate >> 5 & 15, fno.fdate & 31,
+ fno.ftime >> 11, fno.ftime >> 5 & 63);
+ printf("Attributes: %c%c%c%c%c\n",
+ (fno.fattrib & AM_DIR) ? 'D' : '-',
+ (fno.fattrib & AM_RDO) ? 'R' : '-',
+ (fno.fattrib & AM_HID) ? 'H' : '-',
+ (fno.fattrib & AM_SYS) ? 'S' : '-',
+ (fno.fattrib & AM_ARC) ? 'A' : '-');
+ break;
+
+ case FR_NO_FILE:
+ printf("It is not exist.\n");
+ break;
+
+ default:
+ printf("An error occured. (%d)\n", fr);
+ }
+</pre>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="opendir.html">f_opendir</a>, <a href="readdir.html">f_readdir</a>, <a href="sfileinfo.html">FILINFO</a>, <a href="sdir.html">DIR</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/sync.html b/fatfs/doc/ja/sync.html index 74f7910..4b594d6 100644 --- a/fatfs/doc/ja/sync.html +++ b/fatfs/doc/ja/sync.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/sync.html">
@@ -13,25 +13,25 @@ <div class="para func">
<h2>f_sync</h2>
-<p>ݒ̃t@C̃LbVꂽtbV܂B</p>
+<p>書き込み中のファイルのキャッシュされた情報をフラッシュします。</p>
<pre>
FRESULT f_sync (
- FIL* <span class="arg">fp</span> <span class="c">/* [IN] t@CEIuWFNg\̂ւ̃|C^ */</span>
+ FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト構造体へのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>synct@C̃t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>syncするファイルのファイル オブジェクト構造体へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -44,23 +44,23 @@ FRESULT f_sync ( <div class="para desc">
-<h4></h4>
-<p>̊<tt>f_close()</tt>Ɠs܂At@C͈Jꂽ܂܂ɂȂAǂݏsł܂BMOȂǁA݃[hŒԃt@CJĂAvP[VɂāAI܂̗͋ǂƂł̊gp邱ƂɂAsӂ̓dffBA̎Oɂ莸f[^ŏɂ邱Ƃł܂B̔wiɂẮA<a href="appnote.html#critical">AvP[VEm[g</a>QƂĂB</p>
-<p>ۂ̂ƂA<tt>f_close()</tt>ł͂̊Ăяot@CEIuWFNgĂ邾Ȃ̂ŁA<tt>f_close()</tt>O<tt>f_sync()</tt>uƂ͖ӖłB</p>
+<h4>解説</h4>
+<p>この関数は<tt>f_close()</tt>と同じ処理を実行しますが、ファイルは引き続き開かれたままになり、読み書きを続行できます。ロギングなど、書き込みモードで長時間ファイルが開かれているアプリケーションにおいて、定期的または区切りの良いところでこの関数を使用することにより、不意の電源断やメディアの取り外しにより失われるデータを最小にすることができます。この背景については、<a href="appnote.html#critical">アプリケーション ノート</a>も参照してください。</p>
+<p>実際のところ、<tt>f_close()</tt>内ではこの関数を呼び出した後ファイル オブジェクトを無効化しているだけなので、<tt>f_close()</tt>直前に<tt>f_sync()</tt>を置くことは無意味です。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>̂ƂɎgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>のときに使用可能です。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="close.html">f_close</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/tell.html b/fatfs/doc/ja/tell.html index 1dee982..d050691 100644 --- a/fatfs/doc/ja/tell.html +++ b/fatfs/doc/ja/tell.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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_e.html">
<link rel="alternate" hreflang="en" title="English" href="../en/tell.html">
@@ -13,33 +13,33 @@ <div class="para func">
<h2>f_tell</h2>
-<p>݂̃[h/CgE|C^擾܂B</p>
+<p>現在のリード/ライト ポインタを取得します。</p>
<pre>
DWORD f_tell (
- FIL* <span class="arg">fp</span> <span class="c">/* [IN] t@CEIuWFNg */</span>
+ FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
-<p>݂̃[h/CgE|C^(t@C擪̃oCgPʂ̃ItZbg)Ԃ܂B</p>
+<h4>戻り値</h4>
+<p>現在のリード/ライト ポインタ(ファイル先頭からのバイト単位のオフセット)が返ります。</p>
</div>
<div class="para desc">
-<h4></h4>
-<p>f_telĺArWł̓}NƂĎĂ܂B</p>
+<h4>解説</h4>
+<p>f_tell関数は、現リビジョンではマクロとして実装されています。</p>
<pre>
<span class="k">#define</span> f_tell(fp) ((fp)->fptr)
</pre>
@@ -47,16 +47,16 @@ DWORD f_tell ( <div class="para comp">
-<h4>Ή</h4>
-<p>Ɏgp\B</p>
+<h4>対応情報</h4>
+<p>常に使用可能。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="lseek.html">f_lseek</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/truncate.html b/fatfs/doc/ja/truncate.html index 29bf480..b33a757 100644 --- a/fatfs/doc/ja/truncate.html +++ b/fatfs/doc/ja/truncate.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/truncate.html">
@@ -13,25 +13,25 @@ <div class="para func">
<h2>f_truncate</h2>
-<p>t@Cl߂܂B</p>
+<p>ファイル長を切り詰めます。</p>
<pre>
FRESULT f_truncate (
- FIL* <span class="arg">fp</span> <span class="c">/* [IN] t@CEIuWFNgւ̃|C^ */</span>
+ FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクトへのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>lߑΏۃt@C̃t@CEIuWFNgւ̃|C^</dd>
+<dd>切り詰め対象ファイルのファイル オブジェクトへのポインタ</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -45,19 +45,19 @@ FRESULT f_truncate ( <div class="para desc">
-<h4></h4>
-<p>t@C݂̒̃[h/CgE|C^ɐl߂܂B[h/CgE|C^Ƀt@C̏I[wĂƂ́Å͉̌ʂ܂B</p>
+<h4>解説</h4>
+<p>ファイルの長さが現在のリード/ライト ポインタに切り詰められます。リード/ライト ポインタが既にファイルの終端を指しているときは、この関数は何の効果も持ちません。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_FS_MINIMIZE == 0</tt>̂ƂɎgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のときに使用可能です。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="lseek.html">f_lseek</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
diff --git a/fatfs/doc/ja/unlink.html b/fatfs/doc/ja/unlink.html index 7cfb703..3ae691a 100644 --- a/fatfs/doc/ja/unlink.html +++ b/fatfs/doc/ja/unlink.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/unlink.html">
@@ -13,25 +13,25 @@ <div class="para func">
<h2>f_unlink</h2>
-<p>t@C܂̓TuEfBNg폜܂B</p>
+<p>ファイルまたはサブ ディレクトリを削除します。</p>
<pre>
FRESULT f_unlink (
- const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] IuWFNgւ̃|C^ */</span>
+ const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] オブジェクト名へのポインタ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>path</dt>
-<dd>폜Ώۂ<a href="filename.html">pX</a>k<tt>'\0'</tt>I[̕ւ̃|C^w肵܂B</dd>
+<dd>削除対象の<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -53,22 +53,22 @@ FRESULT f_unlink ( <div class="para desc">
-<h4></h4>
-<p>폜Ώۂ̃IuWFNg̏ɓĂ͂܂ꍇÃANZX͋ۂ͎s܂B
+<h4>解説</h4>
+<p>削除対象のオブジェクトが次の条件に当てはまる場合、そのアクセスは拒否され関数は失敗します。
<ul>
-<li>[hEI[(<tt>AM_RDO</tt>)Ăꍇ́A(<tt>FR_DENIED</tt>)B</li>
-<li>łȂTuEfBNg܂̓JgEfBNgłꍇ́A(<tt>FR_DENIED</tt>)B</li>
-<li>JĂt@C܂̓TuEfBNgłꍇ́A<a href="appnote.html#dup">dANZX</a>LȂSɋ(<tt>FR_LOCKED</tt>)܂AłȂƂ͕sȑƂȂA<em>FAT\j\</em>܂B</li>
+<li>リード オンリー属性(<tt>AM_RDO</tt>)を持っている場合は、拒否(<tt>FR_DENIED</tt>)される。</li>
+<li>空でないサブ ディレクトリまたはカレント ディレクトリである場合は、拒否(<tt>FR_DENIED</tt>)される。</li>
+<li>開かれているファイルまたはサブ ディレクトリである場合は、<a href="appnote.html#dup">多重アクセス制御</a>が有効なら安全に拒否(<tt>FR_LOCKED</tt>)されますが、そうでないときは不正な操作となり、<em>FAT構造が破壊される可能性</em>があります。</li>
</ul>
</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_FS_MINIMIZE == 0</tt>̂ƂɎgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のときに使用可能です。</p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/utime.html b/fatfs/doc/ja/utime.html index 382defb..087f57f 100644 --- a/fatfs/doc/ja/utime.html +++ b/fatfs/doc/ja/utime.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/utime.html">
@@ -13,28 +13,28 @@ <div class="para func">
<h2>f_utime</h2>
-<p>t@C܂̓TuEfBNg̃^CX^vύX܂B</p>
+<p>ファイルまたはサブ ディレクトリのタイムスタンプを変更します。</p>
<pre>
FRESULT f_utime (
- const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] IuWFNgւ̃|C^ */</span>
- const FILINFO* <span class="arg">fno</span> <span class="c">/* [IN] ݒ肷t */</span>
+ const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] オブジェクト名へのポインタ */</span>
+ const FILINFO* <span class="arg">fno</span> <span class="c">/* [IN] 設定する日付 */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>path</dt>
-<dd>ύXΏۂ̃IuWFNg<a href="filename.html">pX</a>k<tt>'\0'</tt>I[̕w肵܂B</dd>
+<dd>変更対象のオブジェクトの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列を指定します。</dd>
<dt>fno</dt>
-<dd>ݒ肷tƎԂ<tt>fdate</tt><tt>ftime</tt>oɐݒ肳ꂽ<tt>FILINFO</tt>\̂ւ̃|C^B̃o͂̊ł͈Ӗ܂B</dd>
+<dd>設定する日付と時間を<tt>fdate</tt>と<tt>ftime</tt>メンバに設定された<tt>FILINFO</tt>構造体へのポインタ。他のメンバはこの関数では意味を持ちません。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -54,16 +54,16 @@ FRESULT f_utime ( <div class="para desc">
-<h4></h4>
-<p>IuWFNg̃^CX^vύX܂B</p>
+<h4>解説</h4>
+<p>オブジェクトのタイムスタンプを変更します。</p>
</div>
<div class="para use">
-<h4>gp</h4>
+<h4>使用例</h4>
<pre>
FRESULT set_timestamp (
- char *obj, <span class="c">/* t@Cւ̃|C^ */</span>
+ char *obj, <span class="c">/* ファイル名へのポインタ */</span>
int year,
int month,
int mday,
@@ -84,16 +84,16 @@ FRESULT set_timestamp ( <div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>ŁA<tt>_FS_MINIMIZE == 0</tt>̂ƂɎgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のときに使用可能です。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="stat.html">f_stat</a>, <a href="sfileinfo.html">FILINFO</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
diff --git a/fatfs/doc/ja/write.html b/fatfs/doc/ja/write.html index 35da3fa..c3de4a0 100644 --- a/fatfs/doc/ja/write.html +++ b/fatfs/doc/ja/write.html @@ -1,7 +1,7 @@ <!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=Shift_JIS">
+<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="alternate" hreflang="en" title="English" href="../en/write.html">
@@ -13,34 +13,34 @@ <div class="para func">
<h2>f_write</h2>
-<p>t@CɃf[^݂܂B</p>
+<p>ファイルにデータを書き込みます。</p>
<pre>
FRESULT f_write (
- FIL* <span class="arg">fp</span>, <span class="c">/* [IN] t@CEIuWFNg */</span>
- const void* <span class="arg">buff</span>, <span class="c">/* [IN] ݃f[^ */</span>
- UINT <span class="arg">btw</span>, <span class="c">/* [IN] ރoCg */</span>
- UINT* <span class="arg">bw</span> <span class="c">/* [OUT] ܂ꂽoCg */</span>
+ FIL* <span class="arg">fp</span>, <span class="c">/* [IN] ファイル オブジェクト */</span>
+ const void* <span class="arg">buff</span>, <span class="c">/* [IN] 書き込みデータ */</span>
+ UINT <span class="arg">btw</span>, <span class="c">/* [IN] 書き込むバイト数 */</span>
+ UINT* <span class="arg">bw</span> <span class="c">/* [OUT] 書き込まれたバイト数 */</span>
);
</pre>
</div>
<div class="para arg">
-<h4></h4>
+<h4>引数</h4>
<dl class="par">
<dt>fp</dt>
-<dd>t@CEIuWFNg\̂ւ̃|C^w肵܂B</dd>
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
<dt>buff</dt>
-<dd>ރf[^i[obt@w|C^w肵܂B</dd>
+<dd>書き込むデータを格納したバッファを指すポインタを指定します。</dd>
<dt>btw</dt>
-<dd>ރoCg(0`<tt>UINT</tt>^̍ől)w肵܂B</dd>
+<dd>書き込むバイト数(0～<tt>UINT</tt>型の最大値)を指定します。</dd>
<dt>bw</dt>
-<dd>܂ꂽoCgi[ϐw|C^w肵܂B߂l͊̐ۂɂ炸ɗLłB</dd>
+<dd>書き込まれたバイト数を格納する変数を指すポインタを指定します。戻り値は関数の成否にかかわらず常に有効です。</dd>
</dl>
</div>
<div class="para ret">
-<h4>߂l</h4>
+<h4>戻り値</h4>
<p>
<a href="rc.html#ok">FR_OK</a>,
<a href="rc.html#de">FR_DISK_ERR</a>,
@@ -54,22 +54,22 @@ FRESULT f_write ( <div class="para desc">
-<h4></h4>
-<p>݊JnʒúA[h/CgE|C^̈ʒuɂȂ܂B[h/CgE|C^͎ۂɏ܂ꂽoCgi݂܂BIAvoCg܂ꂽǂ<tt class="arg">*bw</tt>`FbNׂłB<tt class="arg">*bw</tt><tt class="arg">btw</tt>菬Ƃ́AfBXNEtӖ܂BfBXNEtĂƂ܂͂ɋ߂Ƃ́A䂪A܂ŎԂꍇ܂B</p>
+<h4>解説</h4>
+<p>書き込み開始位置は、リード/ライト ポインタの位置からになります。リード/ライト ポインタは実際に書き込まれたバイト数だけ進みます。関数が正常終了した後、要求したバイト数が書き込まれたかどうか<tt class="arg">*bw</tt>をチェックすべきです。<tt class="arg">*bw</tt>が<tt class="arg">btw</tt>より小さいときは、ディスク フルを意味します。ディスク フルが発生しているときまたはそれに近いときは、制御が帰るまで時間がかかる場合があります。</p>
</div>
<div class="para comp">
-<h4>Ή</h4>
-<p><tt>_FS_READONLY == 0</tt>̂ƂɎgp\łB</p>
+<h4>対応情報</h4>
+<p><tt>_FS_READONLY == 0</tt>のときに使用可能です。</p>
</div>
<div class="para ref">
-<h4>Q</h4>
+<h4>参照</h4>
<p><tt><a href="open.html">f_open</a>, <a href="read.html">f_read</a>, <a href="putc.html">fputc</a>, <a href="puts.html">fputs</a>, <a href="printf.html">fprintf</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p>
</div>
-<p class="foot"><a href="../00index_j.html">߂</a></p>
+<p class="foot"><a href="../00index_j.html">戻る</a></p>
</body>
</html>
|