]> cloudbase.mooo.com Git - z180-stamp.git/blobdiff - fatfs/doc/ja/setlabel.html
Import fatfs R0.12b
[z180-stamp.git] / fatfs / doc / ja / setlabel.html
index af4a243759d07754a16c7a44644f74fd1f0ec1e6..d578fa180e953075b2580472b3f82659da7bda60 100644 (file)
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">\r
 <html lang="ja">\r
 <head>\r
-<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">\r
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">\r
 <meta http-equiv="Content-Style-Type" content="text/css">\r
 <link rel="up" title="FatFs" href="../00index_j.html">\r
 <link rel="alternate" hreflang="en" title="English" href="../en/setlabel.html">\r
 \r
 <div class="para func">\r
 <h2>f_setlabel</h2>\r
-<p>\83{\83\8a\83\85\81[\83\80\82É\83{\83\8a\83\85\81[\83\80\81E\83\89\83x\83\8b\82ð\90Ý\92è\82µ\82Ü\82·\81B</p>\r
+<p>ボリュームにボリューム ラベルを設定します。</p>\r
 <pre>\r
 FRESULT f_setlabel (\r
-  const TCHAR* <span class="arg">label</span>  <span class="c">/* [IN] \90Ý\92è\82·\82é\83{\83\8a\83\85\81[\83\80\81E\83\89\83x\83\8b\82Ö\82Ì\83|\83C\83\93\83^ */</span>\r
+  const TCHAR* <span class="arg">label</span>  <span class="c">/* [IN] 設定するボリューム ラベルへのポインタ */</span>\r
 );\r
 </pre>\r
 </div>\r
 \r
 <div class="para arg">\r
-<h4>\88ø\90\94</h4>\r
+<h4>引数</h4>\r
 <dl class="par">\r
 <dt>label</dt>\r
-<dd>\90Ý\92è\82·\82é\83{\83\8a\83\85\81[\83\80\81E\83\89\83x\83\8b\82ð\8e¦\82·\83k\83\8b\95\8e\9a<tt>'\0'</tt>\8fI\92[\82Ì\95\8e\9a\97ñ\82Ö\82Ì\83|\83C\83\93\83^\82ð\8ew\92è\82µ\82Ü\82·\81B</dd>\r
+<dd>設定するボリューム ラベルを示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd>\r
 </dl>\r
 </div>\r
 \r
 \r
 <div class="para ret">\r
-<h4>\96ß\82è\92l</h4>\r
+<h4>戻り値</h4>\r
 <p>\r
 <a href="rc.html#ok">FR_OK</a>,\r
 <a href="rc.html#de">FR_DISK_ERR</a>,\r
@@ -48,42 +48,44 @@ FRESULT f_setlabel (
 \r
 \r
 <div class="para desc">\r
-<h4>\89ð\90à</h4>\r
-<p>\95\8e\9a\97ñ\82Ì\90æ\93ª\82É\83h\83\89\83C\83u\94Ô\8d\86\82ð\8aÜ\82Þ\8fê\8d\87\82Í\81A\82»\82Ì\98_\97\9d\83h\83\89\83C\83u\82É\91Î\82µ\82Ä\90Ý\92è\82³\82ê\82Ü\82·\81B\8aÜ\82Ü\82È\82¢\8fê\8d\87\82Í\81A\83f\83t\83H\83\8b\83g\81E\83h\83\89\83C\83u\82É\90Ý\92è\82³\82ê\82Ü\82·\81B\83{\83\8a\83\85\81[\83\80\81E\83\89\83x\83\8b\82ð\8dí\8f\9c\82·\82é\82Æ\82«\82Í\81A\83k\83\8b\95\8e\9a\97ñ\82ð\8ew\92è\82µ\82Ü\82·\81B\83{\83\8a\83\85\81[\83\80\81E\83\89\83x\83\8b\82Ì\83t\83H\81[\83}\83b\83g\82Í\81A\83t\83@\83C\83\8b\96¼(SFN)\82Æ\82Ù\82Ú\93¯\82\82Å\82·\82ª\81A\8e\9f\82Ì\93_\82ª\88Ù\82È\82è\82Ü\82·\81B</p>\r
+<h4>解説</h4>\r
+<p>文字列の先頭にドライブ番号を含む場合は、その論理ドライブに対して設定されます。含まない場合は、デフォルト ドライブに設定されます。ボリューム ラベルを削除するときは、ヌル文字列を指定します。FATボリューム上では、ボリューム ラベルのフォーマットは、ファイル名とほぼ同じですが、次の点が異なります。</p>\r
 <ul>\r
-<li>\83\8d\81[\83J\83\8b\95\8e\9a\83R\81[\83h\8a·\8eZ\82Å11\83o\83C\83g\88È\89º\81BLFN\8ag\92£\82Í\93K\97p\82³\82ê\82Ü\82¹\82ñ\81B</li>\r
-<li>\83s\83\8a\83I\83h\82ð\8aÜ\82Þ\82±\82Æ\82Í\82Å\82«\82È\82¢\81B</li>\r
-<li>\94C\88Ó\82Ì\88Ê\92u\82É\83X\83y\81[\83X\82ð\92u\82­\82±\82Æ\82ª\82Å\82«\82é\81B\82½\82¾\82µ\81A\8dÅ\8cã\94ö\82Æ\82È\82é\83X\83y\81[\83X\82Í\8f\9c\8b\8e\82³\82ê\82é\81B</li>\r
+<li>任意の位置にスペースを置くことができる。ただし、FATボリュームではトレーリング スペースは除去される。</li>\r
+<li>ピリオドを含むことはできない。</li>\r
+<li>FATボリュームでは、OEMコード換算で11バイト以下。</li>\r
+<li>exFATボリュームでは、11文字以下で、大文字小文字は保持される。</li>\r
 </ul>\r
+<p>【補足】 標準システム(Windows)では<tt>\xE5</tt>で始まるボーリューム ラベル(CP932なら「薔薇」など)の扱いに問題があります。このため、この関数ではそのような名前は無効として処理しています。</p>\r
 </div>\r
 \r
 <div class="para comp">\r
-<h4>\91Î\89\9e\8fî\95ñ</h4>\r
-<p><tt>_FS_READONLY == 0</tt>\82Å\81A\8a\8e\82Â<tt>_USE_LABEL == 1</tt>\82Ì\82Æ\82«\82É\8eg\97p\89Â\94\\82Å\82·\81B</p>\r
+<h4>対応情報</h4>\r
+<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_LABEL == 1</tt>のときに使用可能です。</p>\r
 </div>\r
 \r
 \r
 <div class="para use">\r
-<h4>\8eg\97p\97á</h4>\r
+<h4>使用例</h4>\r
 <pre>\r
-    <span class="c">/* \83f\83t\83H\83\8b\83g\81E\83h\83\89\83C\83u\82É\83{\83\8a\83\85\81[\83\80\81E\83\89\83x\83\8b\82ð\90Ý\92è */</span>\r
+    <span class="c">/* デフォルト ドライブにボリューム ラベルを設定 */</span>\r
     f_setlabel("DATA DISK");\r
 \r
-    <span class="c">/* \83h\83\89\83C\83u2\82É\83{\83\8a\83\85\81[\83\80\81E\83\89\83x\83\8b\82ð\90Ý\92è */</span>\r
+    <span class="c">/* ドライブ2にボリューム ラベルを設定 */</span>\r
     f_setlabel("2:DISK 3 OF 4");\r
 \r
-    <span class="c">/* \83h\83\89\83C\83u2\82Ì\83{\83\8a\83\85\81[\83\80\81E\83\89\83x\83\8b\82ð\8dí\8f\9c */</span>\r
+    <span class="c">/* ドライブ2のボリューム ラベルを削除 */</span>\r
     f_setlabel("2:");\r
 </pre>\r
 </div>\r
 \r
 \r
 <div class="para ref">\r
-<h4>\8eQ\8fÆ</h4>\r
+<h4>参照</h4>\r
 <tt><a href="getlabel.html">f_getlabel</a></tt>\r
 </div>\r
 \r
 \r
-<p class="foot"><a href="../00index_j.html">\96ß\82é</a></p>\r
+<p class="foot"><a href="../00index_j.html">戻る</a></p>\r
 </body>\r
 </html>\r