Convert release and draft pages to UTF-8.

[linuxjm/jm.git] / manual / LDP_man-pages / draft / man3 / basename.3

diff --git a/manual/LDP_man-pages/draft/man3/basename.3 b/manual/LDP_man-pages/draft/man3/basename.3
index 43fdfb1..cc2fd36 100644 (file)
--- a/manual/LDP_man-pages/draft/man3/basename.3
+++ b/manual/LDP_man-pages/draft/man3/basename.3
@@ -30,10 +30,10 @@
 .TH BASENAME 3  2009-03-30 "GNU" "Linux Programmer's Manual"
 .\"O .SH NAME
 .\"O basename, dirname \- parse pathname components
-.SH ̾Á°
-basename, dirname \- ¥Ñ¥¹Ì¾¤ò²òÀϤ·¤Æ³ÆÉôʬ¤ò¼è¤ê½Ð¤¹
+.SH 名前
+basename, dirname \- パス名を解析して各部分を取り出す
 .\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
 .nf
 .B #include <libgen.h>
 .sp
@@ -42,13 +42,13 @@ basename, dirname \- 
 .BI "char *basename(char *" path );
 .fi
 .\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
 .\"O Warning: there are two different functions
 .\"O .BR basename ()
 .\"O - see below.
-·Ù¹ð:
+警告:
 .BR basename ()
-¤Ë¤Ï°Û¤Ê¤ë¥Ð¡¼¥¸¥ç¥ó¤¬ 2¤Ä¸ºß¤¹¤ë¡£²¼µ­¤Î¡ÖÃí°Õ¡×¤ÎÀá¤ò»²¾È¤Î¤³¤È¡£
+には異なるバージョンが 2つ存在する。下記の「注意」の節を参照のこと。
 .LP
 .\"O The functions
 .\"O .BR dirname ()
@@ -63,16 +63,16 @@ basename, dirname \- 
 .\"O returns the component following the final \(aq/\(aq.
 .\"O Trailing \(aq/\(aq characters are not counted as part of the pathname.
 .BR dirname ()
-¤È
+と
 .BR basename ()
-¤Ï¡¢NULL ¤Ç½ªÃ¼¤µ¤ì¤¿¥Ñ¥¹Ì¾¤Îʸ»úÎó¤ò¡¢
-¥Ç¥£¥ì¥¯¥È¥êÉôʬ¡¦¥Õ¥¡¥¤¥ë̾Éôʬ¤Ëʬ³ä¤¹¤ë¡£
-Ä̾ï¤Ï¡¢
+は、NULL で終端されたパス名の文字列を、
+ディレクトリ部分・ファイル名部分に分割する。
+通常は、
 .BR dirname ()
-¤ÏºÇ¸å¤Î \(aq/\(aq ¤Þ¤Ç¤ÎÉôʬ (ºÇ¸å¤Î \(aq/\(aq ¤Ï´Þ¤Þ¤Ê¤¤) ¤òÊÖ¤·¡¢
+は最後の \(aq/\(aq までの部分 (最後の \(aq/\(aq は含まない) を返し、
 .BR basename ()
-¤ÏºÇ¸å¤Î \(aq/\(aq °Ê¹ß¤ÎÉôʬ¤òÊÖ¤¹¡£
-ʸ»úÎó¤ÎËöÈø¤Ë¤Ä¤¤¤¿ \(aq/\(aq ʸ»ú¤Ï¡¢¥Ñ¥¹Ì¾¤Î°ìÉô¤È¤Ï¤ß¤Ê¤µ¤ì¤Ê¤¤¡£
+は最後の \(aq/\(aq 以降の部分を返す。
+文字列の末尾についた \(aq/\(aq 文字は、パス名の一部とはみなされない。
 .PP
 .\"O If
 .\"O .I path
@@ -97,25 +97,25 @@ basename, dirname \- 
 .\"O .BR basename ()
 .\"O return the string ".".
 .I path
-¤Ë '/' ʸ»ú¤¬¤Ê¤¤¾ì¹ç¤Ï¡¢
+に '/' 文字がない場合は、
 .BR dirname ()
-¤Ïʸ»úÎó "." ¤òÊÖ¤·¡¢
+は文字列 "." を返し、
 .BR basename ()
-¤Ï
+は
 .I path
-¤ÈƱ¤¸ÆâÍƤòÊÖ¤¹¡£
+と同じ内容を返す。
 .I path
-¤¬Ê¸»úÎó "/" ¤ËÅù¤·¤¤¾ì¹ç¤Ï¡¢
+が文字列 "/" に等しい場合は、
 .BR dirname ()
-¤â
+も
 .BR basename ()
-¤âʸ»úÎó "/" ¤òÊÖ¤¹¡£
+も文字列 "/" を返す。
 .I path
-¤¬ NULL ¥Ý¥¤¥ó¥¿¤À¤Ã¤¿¤ê¡¢¶õ¤Îʸ»úÎó¤ò»Ø¤·¤Æ¤¤¤¿¾ì¹ç¤Ï¡¢
+が NULL ポインタだったり、空の文字列を指していた場合は、
 .BR dirname ()
-¤â
+も
 .BR basename ()
-¤âʸ»úÎó "." ¤òÊÖ¤¹¡£
+も文字列 "." を返す。
 .PP
 .\"O Concatenating the string returned by
 .\"O .BR dirname (),
@@ -123,10 +123,10 @@ basename, dirname \- 
 .\"O .BR basename ()
 .\"O yields a complete pathname.
 .BR dirname ()
-¤ÎÊÖ¤·¤¿Ê¸»úÎó¡¢ "/"¡¢
+の返した文字列、 "/"、
 .BR basename ()
-¤ÎÊÖ¤·¤¿Ê¸»úÎó¡¢
-¤ò½ç¤Ë·ë¹ç¤¹¤ë¤È¡¢´°Á´¤Ê¥Ñ¥¹Ì¾¤¬ÆÀ¤é¤ì¤ë¡£
+の返した文字列、
+を順に結合すると、完全なパス名が得られる。
 .PP
 .\"O Both
 .\"O .BR dirname ()
@@ -137,13 +137,13 @@ basename, dirname \- 
 .\"O so it may be desirable to pass a copy when calling one of
 .\"O these functions.
 .BR dirname ()
-¤È
+と
 .BR basename ()
-¤Ï¡¢¤¤¤º¤ì¤â
+は、いずれも
 .I path
-¤ÎÆâÍƤòÊѹ¹¤¹¤ë¤³¤È¤¬¤¢¤ë¡£
-¤·¤¿¤¬¤Ã¤Æ¡¢¤³¤ì¤é¤Î´Ø¿ô¤ò¸Æ¤Ó½Ð¤¹ºÝ¤Ë¤Ï
-¥³¥Ô¡¼¤òÅϤ¹¤Î¤¬Ë¾¤Þ¤·¤¤¡£
+の内容を変更することがある。
+したがって、これらの関数を呼び出す際には
+コピーを渡すのが望ましい。
 .PP
 .\"O These functions may return pointers to statically allocated memory
 .\"O which may be overwritten by subsequent calls.
@@ -153,14 +153,14 @@ basename, dirname \- 
 .\"O .I path
 .\"O should not be modified or freed until the pointer returned by
 .\"O the function is no longer required.
-¤³¤ì¤é¤Î´Ø¿ô¤Ï¡¢ÀÅŪ¤Ë³ä¤êÅö¤Æ¤é¤ì¤¿¥á¥â¥ê¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¤³¤È¤¬¤¢¤ê¡¢
-¤³¤ì¤é¤ÎÎΰè¤Ï¸å¤Î´Ø¿ô¸Æ¤Ó½Ð¤·¤Ç¾å½ñ¤­¤µ¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
-¤Þ¤¿¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï
+これらの関数は、静的に割り当てられたメモリへのポインタを返すことがあり、
+これらの領域は後の関数呼び出しで上書きされるかもしれない。
+また、これらの関数は
 .I path
-¤Î°ìÉôʬ¤ò»Ø¤¹¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¤³¤È¤â¤¢¤ë¡£¤½¤Î¤¿¤á¡¢
+の一部分を指すポインタを返すこともある。そのため、
 .I path
-¤Ç»²¾È¤µ¤ì¤ëʸ»úÎó¤Ï¡¢´Ø¿ô¤¬ÊÖ¤¹¥Ý¥¤¥ó¥¿¤¬ÉÔÍפˤʤë¤Þ¤Ç¤Ï
-Êѹ¹¤·¤¿¤ê free ¤·¤¿¤ê¤¹¤Ù¤­¤Ç¤Ï¤Ê¤¤¡£
+で参照される文字列は、関数が返すポインタが不要になるまでは
+変更したり free したりすべきではない。
 .PP
 .\"O The following list of examples (taken from SUSv2)
 .\"O shows the strings returned by
@@ -168,12 +168,12 @@ basename, dirname \- 
 .\"O and
 .\"O .BR basename ()
 .\"O for different paths:
-°Ê²¼¤Î°ìÏ¢¤ÎÎã (SUSv2 ¤«¤é°úÍÑ) ¤Ï¡¢
-¤¤¤í¤¤¤í¤Ê path ¤ËÂФ·¤Æ
+以下の一連の例 (SUSv2 から引用) は、
+いろいろな path に対して
 .BR dirname ()
-¤È
+と
 .BR basename ()
-¤¬ÊÖ¤¹Ê¸»úÎó¤òɽ¤·¤¿¤â¤Î¤Ç¤¢¤ë¡£
+が返す文字列を表したものである。
 .sp
 .nf
 .B "path         dirname    basename"
@@ -185,7 +185,7 @@ basename, dirname \- 
 ".."          "."       ".."
 .fi
 .\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
+.SH 返り値
 .\"O Both
 .\"O .BR dirname ()
 .\"O and
@@ -194,31 +194,31 @@ basename, dirname \- 
 .\"O (Do not pass these pointers to
 .\"O .BR free (3).)
 .BR dirname ()
-¤È
+と
 .BR basename ()
-¤Ï¡¢¤¤¤º¤ì¤â NULL ¤Ç½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
-(¤³¤ì¤é¤Î¥Ý¥¤¥ó¥¿¤ò
+は、いずれも NULL で終端された文字列へのポインタを返す。
+(これらのポインタを
 .BR free (3)
-¤ËÅϤµ¤Ê¤¤¤³¤È¡£)
+に渡さないこと。)
 .\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH 準拠
 POSIX.1-2001.
 .\"O .SH NOTES
-.SH Ãí°Õ
+.SH 注意
 .\"O There are two different versions of
 .\"O .BR basename ()
 .\"O - the POSIX version described above, and the GNU version, which one gets
 .\"O after
 .BR basename ()
-¤Ë¤Ï 2¼ïÎà¤Î°Û¤Ê¤ë¥Ð¡¼¥¸¥ç¥ó¤¬¤¢¤ë¡£
-°ì¤Ä¤Ï¤¹¤Ç¤ËÀâÌÀ¤·¤¿ POSIX ¥Ð¡¼¥¸¥ç¥ó¤Ç¤¢¤ê¡¢
-¤â¤¦°ì¤Ä¤Ï GNU ¥Ð¡¼¥¸¥ç¥ó¤Ç¤¢¤ë¡£
-GNU ¥Ð¡¼¥¸¥ç¥ó¤ò»ÈÍѤ¹¤ë¤Ë¤Ï°Ê²¼¤Î¤è¤¦¤Ë¤¹¤ë¡£
+には 2種類の異なるバージョンがある。
+一つはすでに説明した POSIX バージョンであり、
+もう一つは GNU バージョンである。
+GNU バージョンを使用するには以下のようにする。
 .br
 .nf
 
 .\"O .BR "    #define _GNU_SOURCE" "         /* See feature_test_macros(7) */"
-.BR "    #define _GNU_SOURCE" "         /* feature_test_macros(7) »²¾È */"
+.BR "    #define _GNU_SOURCE" "         /* feature_test_macros(7) 参照 */"
 .br
 .B "    #include <string.h>"
 
@@ -229,43 +229,43 @@ GNU 
 .\"O has a trailing slash, and in particular also when it is "/".
 .\"O There is no GNU version of
 .\"O .BR dirname ().
-GNU ¥Ð¡¼¥¸¥ç¥ó¤Ï°ú¤­¿ô¤òÊѹ¹¤¹¤ë¤³¤È¤Ï¤Ê¤¯¡¢
+GNU バージョンは引き数を変更することはなく、
 .I path
-¤ÎËöÈø¤¬ '/'¤Î¾ì¹ç¤Ï¶õ¤Îʸ»úÎó¤òÊÖ¤¹¡£
-ÆäË
+の末尾が '/'の場合は空の文字列を返す。
+特に
 .I path
-¤¬ "/" ¤Î¾ì¹ç¤â¶õʸ»úÎó¤òÊÖ¤¹¡£
+が "/" の場合も空文字列を返す。
 .BR dirname ()
-¤Ë¤Ï GNU ¥Ð¡¼¥¸¥ç¥ó¤Ï¤Ê¤¤¡£
+には GNU バージョンはない。
 .LP
 .\"O With glibc, one gets the POSIX version of
 .\"O .BR basename ()
 .\"O when
 .\"O .I <libgen.h>
 .\"O is included, and the GNU version otherwise.
-glibc ¤Ç¤Ï¡¢
+glibc では、
 .I <libgen.h>
-¤ò¥¤¥ó¥¯¥ë¡¼¥É¤¹¤ë¤È POSIX ¥Ð¡¼¥¸¥ç¥ó¤Î
+をインクルードすると POSIX バージョンの
 .BR basename ()
-¤¬»ÈÍѤµ¤ì¡¢¤½¤ì°Ê³°¤Î¾ì¹ç¤Ï GNU ¥Ð¡¼¥¸¥ç¥ó¤È¤Ê¤ë¡£
+が使用され、それ以外の場合は GNU バージョンとなる。
 .\"O .SH BUGS
-.SH ¥Ð¥°
+.SH ã\83\90ã\82°
 .\"O In the glibc implementation of the POSIX versions of these functions
 .\"O they modify their argument, and segfault when called with a static string
 .\"O like "/usr/".
-glibc ¤Î POSIX ¥Ð¡¼¥¸¥ç¥ó¤Î¼ÂÁõ¤Ç¤Ï¡¢°ú¤­¿ô¤ÎÆâÍƤ¬Êѹ¹¤µ¤ì¡¢
-°ú¤­¿ô¤Ë ("/usr/" ¤Ê¤É¤Î) Äê¿ôʸ»úÎó¤ò»ØÄꤵ¤ì¤ë¤È
-¥»¥°¥á¥ó¥Æ¡¼¥·¥ç¥ó¥Õ¥©¡¼¥ë¥È¤òµ¯¤³¤¹¡£
+glibc の POSIX バージョンの実装では、引き数の内容が変更され、
+引き数に ("/usr/" などの) 定数文字列を指定されると
+セグメンテーションフォールトを起こす。
 .\"O Before glibc 2.2.1, the glibc version of
 .\"O .BR dirname ()
 .\"O did not correctly handle pathnames with trailing \(aq/\(aq characters,
 .\"O and generated a segfault if given a NULL argument.
-¥Ð¡¼¥¸¥ç¥ó 2.2.1 °ÊÁ°¤Î glibc ¤Ç¤Ï¡¢ glibc ¤Î
+バージョン 2.2.1 以前の glibc では、 glibc の
 .BR dirname ()
-¤ÏËöÈø¤¬ \(aq/\(aq ʸ»ú¤Ë¤Ê¤Ã¤Æ¤¤¤ë¥Ñ¥¹Ì¾¤òÀµ¤·¤¯°·¤¨¤º¡¢
-°ú¤­¿ô¤¬ NULL ¤À¤È¥»¥°¥á¥ó¥Æ¡¼¥·¥ç¥ó¥Õ¥©¡¼¥ë¥È¤òµ¯¤³¤·¤¿¡£
+は末尾が \(aq/\(aq 文字になっているパス名を正しく扱えず、
+引き数が NULL だとセグメンテーションフォールトを起こした。
 .\"O .SH EXAMPLE
-.SH Îã
+.SH 例
 .in +4n
 .nf
 char *dirc, *basec, *bname, *dname;
@@ -279,6 +279,6 @@ printf("dirname=%s, basename=%s\\n", dname, bname);
 .fi
 .in
 .\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
 .BR basename (1),
 .BR dirname (1)