FatFs - f_setlabel

Date: Thu, 23 Aug 2018 17:08:59 +0200 Subject: o Initial import. --- .../external/fatfs/doc/ja/setlabel.html | 91 ++++++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/setlabel.html (limited to 'thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/setlabel.html') diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/setlabel.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/setlabel.html new file mode 100644 index 0000000..c121719 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/setlabel.html @@ -0,0 +1,91 @@ + + + + + + + + +FatFs - f_setlabel + + + + +

f_setlabel

ボリュームにボリュームラベルを設定します。

+FRESULT f_setlabel (
+  const TCHAR* label  /* [IN] 設定するボリューム ラベルへのポインタ */
+);
+

+ +

引数

label: 設定するボリュームラベルを示すヌル文字'\0'終端の文字列へのポインタを指定します。

+ + +

戻り値

+FR_OK, +FR_DISK_ERR, +FR_INT_ERR, +FR_NOT_READY, +FR_INVALID_NAME, +FR_WRITE_PROTECTED, +FR_INVALID_DRIVE, +FR_NOT_ENABLED, +FR_NO_FILESYSTEM, +FR_TIMEOUT +

+ + +

解説

文字列の先頭にドライブ番号を含む場合は、その論理ドライブに対して設定されます。含まない場合は、デフォルトドライブに設定されます。ボリュームラベルを削除するときは、ヌル文字列を指定します。FATボリューム上では、ボリュームラベルのフォーマットは、ファイル名とほぼ同じですが、次の点が異なります。

任意の位置にスペースを置くことができる。ただし、FATボリュームではトレーリングスペースは除去される。
ピリオドを含むことはできない。
FATボリュームでは、OEMコード換算で11バイト以下。
exFATボリュームでは、11文字以下で、大文字小文字は保持される。

【補足】標準システム(Windows)では\xE5で始まるボーリュームラベル(CP932なら「薔薇」など)の扱いに問題があります。このため、この関数ではそのような名前は無効として処理しています。

+ +

対応情報

_FS_READONLY == 0で、且つ_USE_LABEL == 1のときに使用可能です。

+ + +

使用例

+    /* デフォルト ドライブにボリューム ラベルを設定 */
+    f_setlabel("DATA DISK");
+
+    /* ドライブ2にボリューム ラベルを設定 */
+    f_setlabel("2:DISK 3 OF 4");
+
+    /* ドライブ2のボリューム ラベルを削除 */
+    f_setlabel("2:");
+

+ + +

参照

+f_getlabel +

+ + +

戻る

+ + -- cgit v1.2.3