OSDN Git Service

(split) Convert release and draft pages to UTF-8.
[linuxjm/LDP_man-pages.git] / release / man3 / fnmatch.3
index 5a7bda7..0eac0ae 100644 (file)
 .\" Updated 2006-03-05, Akihiro MOTOKI, catch up to LDP v2.25
 .\"
 .TH FNMATCH 3  2000-10-15 "GNU" "Linux Programmer's Manual"
-.SH Ì¾Á°
-fnmatch \- ¥Õ¥¡¥¤¥ë̾¤Þ¤¿¤Ï¥Ñ¥¹Ì¾¤Ø¤Î¥Þ¥Ã¥Á¤ò¹Ô¤¦
-.SH ½ñ¼°
+.SH 名前
+fnmatch \- ファイル名またはパス名へのマッチを行う
+.SH 書式
 .nf
 .B #include <fnmatch.h>
 .sp
 .BI "int fnmatch(const char *" "pattern" ", const char *" string ", int " flags );
 .fi
-.SH ÀâÌÀ
+.SH 説明
 .BR fnmatch ()
-´Ø¿ô¤Ï
+関数は
 .I strings
-°ú¤­¿ô¤¬
+引き数が
 .I pattern
-°ú¤­¿ô¤Ë¥Þ¥Ã¥Á¤¹¤ë¤«¤ò¥Á¥§¥Ã¥¯¤¹¤ë¡£
+引き数にマッチするかをチェックする。
 .I pattern
-¤Ë¤Ï¥·¥§¥ë¤Î¥ï¥¤¥ë¥É¥«¡¼¥É¥Ñ¥¿¡¼¥ó¤òÍ¿¤¨¤ë¡£
+にはシェルのワイルドカードパターンを与える。
 .PP
 .I flags
-°ú¤­¿ô¤Ë¤è¤êÆ°ºî¤òÊѹ¹¤Ç¤­¤ë¡£
+引き数により動作を変更できる。
 .I flags
-¤Ï°Ê²¼¤Î¥Õ¥é¥°¤Î¥Ó¥Ã¥ÈËè¤Î OR ¤Ç»ØÄꤹ¤ë¡£
+は以下のフラグのビット毎の OR で指定する。
 .TP
 .B FNM_NOESCAPE
-¤³¤Î¥Õ¥é¥°¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤ë¤È¡¢¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å (\\) ¤ò¥¨¥¹¥±¡¼¥×ʸ»ú
-¤Ç¤Ï¤Ê¤¯Ä̾ï¤Îʸ»ú¤È¤·¤Æ°·¤¦¡£
+このフラグがセットされていると、バックスラッシュ (\\) をエスケープ文字
+ではなく通常の文字として扱う。
 .TP
 .B FNM_PATHNAME
-¤³¤Î¥Õ¥é¥°¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤ë¤È¡¢
+このフラグがセットされていると、
 .I string
-Ãæ¤Î¥¹¥é¥Ã¥·¥å (/) ¤ò
+中のスラッシュ (/) を
 .I pattern
-¤Ë¤¢¤ë¥¹¥é¥Ã¥·¥å¤½¤Î¤â¤Î¤Ë¤À¤±¥Þ¥Ã¥Á¤µ¤»¡¢
-¥¢¥¹¥¿¥ê¥¹¥¯ (*) ¤äµ¿ÌäÉä (?) ¤Î¥á¥¿¥­¥ã¥é¥¯¥¿¤ä¡¢
-¥¹¥é¥Ã¥·¥å¤ò´Þ¤à¥Ö¥é¥±¥Ã¥Èɽ¸½ ([]) ¤Ë¤Ï¥Þ¥Ã¥Á¤µ¤»¤Ê¤¤¡£
+にあるスラッシュそのものにだけマッチさせ、
+アスタリスク (*) や疑問符 (?) のメタキャラクタや、
+スラッシュを含むブラケット表現 ([]) にはマッチさせない。
 .TP
 .B FNM_PERIOD
-¤³¤Î¥Õ¥é¥°¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤ë¤È¡¢
+このフラグがセットされていると、
 .I string
-¤ÎÀèƬ¥Ô¥ê¥ª¥É (leading period) ¤Ï
+の先頭ピリオド (leading period) は
 .I pattern
-Ãæ¤Î¥Ô¥ê¥ª¥É¤½¤Î¤â¤Î¤Ë¤·¤«¥Þ¥Ã¥Á¤·¤Ê¤¤¡£ÀèƬ¥Ô¥ê¥ª¥É¤È¤Ï¡¢
+中のピリオドそのものにしかマッチしない。先頭ピリオドとは、
 .I string
-¤ÎºÇ½é¤Îʸ»ú°ÌÃ֤ˤ¢¤ë¥Ô¥ê¥ª¥É¤Î¤³¤È¤Ç¤¢¤ë¡£¤¿¤À¤·
+の最初の文字位置にあるピリオドのことである。ただし
 .B FNM_PATHNAME
-¥Õ¥é¥°¤¬Æ±»þ¤Ë¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ë¤Ï¡¢¥¹¥é¥Ã¥·¥å¤Îľ¸å¤Ë³¤¯¥Ô¥ê¥ª¥É
-¤âÀèƬ¥Ô¥ê¥ª¥É¤È¤ß¤Ê¤µ¤ì¤ë¡£
+フラグが同時にセットされている場合には、スラッシュの直後に続くピリオド
+も先頭ピリオドとみなされる。
 .TP
 .B FNM_FILE_NAME
-¤³¤ì¤Ï \fBFNM_PATHNAME\fR ¤ËÂФ¹¤ë GNU ¤Ç¤ÎƱµÁ¸ì¤Ç¤¢¤ë.
+これは \fBFNM_PATHNAME\fR に対する GNU での同義語である.
 .TP
 .B FNM_LEADING_DIR
-¤³¤Î¥Õ¥é¥°¤Ï GNU ¤Ç¤Î³ÈÄ¥¤Ç¤¢¤ë¡£¤³¤ì¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ë¤Ï¡¢
-¥Ñ¥¿¡¼¥ó¤¬
+このフラグは GNU での拡張である。これがセットされている場合には、
+パターンが
 .I string
-¤ÎºÇ½é¤ÎÉôʬ (¤Ë¥¹¥é¥Ã¥·¥å¤òÉÕ¤±¤¿¤â¤Î) ¤Ë¥Þ¥Ã¥Á¤¹¤ì¤Ð¡¢
-¥Þ¥Ã¥Á¤·¤¿¤â¤Î¤È¤ß¤Ê¤µ¤ì¤ë¡£
-¤³¤Î¥Õ¥é¥°¤Ï¼ç¤È¤·¤Æ glibc ¤ÇÆâÉôŪ¤Ë»ÈÍѤ·¡¢¤½¤Î¤¿¤á¤Î¤ß¼ÂÁõ¤µ¤ì¤Æ¤¤¤ë¡£
+の最初の部分 (にスラッシュを付けたもの) にマッチすれば、
+マッチしたものとみなされる。
+このフラグは主として glibc で内部的に使用し、そのためのみ実装されている。
 .TP
 .B FNM_CASEFOLD
-¤³¤Î¥Õ¥é¥°¤Ï GNU ¤Ç¤Î³ÈÄ¥¤Ç¤¢¤ë¡£¤³¤ì¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ë¤Ï¡¢
-¥Ñ¥¿¡¼¥ó¤Î¥Þ¥Ã¥Á¤ËÂçʸ»ú¾®Ê¸»ú¤¬¶èÊ̤µ¤ì¤Ê¤¤¡£
-.SH ÊÖ¤êÃÍ
+このフラグは GNU での拡張である。これがセットされている場合には、
+パターンのマッチに大文字小文字が区別されない。
+.SH 返り値
 .I string
-¤¬
+が
 .I pattern
-¤Ë¥Þ¥Ã¥Á¤¹¤ì¤Ð 0 ¤òÊÖ¤¹¡£¥Þ¥Ã¥Á¤·¤Ê¤«¤Ã¤¿¾ì¹ç¤Ë¤Ï
+にマッチすれば 0 を返す。マッチしなかった場合には
 .B FNM_NOMATCH
-¤òÊÖ¤¹¡£¥¨¥é¡¼¤Î¾ì¹ç¤Ë¤Ï¤½¤ì°Ê³°¤ÎÈó¥¼¥íÃͤòÊÖ¤¹¡£
-.SH ½àµò
+を返す。エラーの場合にはそれ以外の非ゼロ値を返す。
+.SH 準拠
 POSIX.2.
 .BR FNM_FILE_NAME ", " FNM_LEADING_DIR ", " FNM_CASEFOLD
-¥Õ¥é¥°¤Ï GNU ¤Î³ÈÄ¥¤Ç¤¢¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
+フラグは GNU の拡張である。
+.SH 関連項目
 .BR sh (1),
 .BR glob (3),
 .BR scandir (3),