fc733ebccd
This section is based on catpages contributed by Mainichi Communications, Inc. Translated by: MYCOM team Converted by: Japanese Online Manual Project <man-jp@jp.FreeBSD.ORG> Submitted by: Kazuo Horikawa <k-horik@yk.rim.or.jp>
458 lines
11 KiB
Groff
458 lines
11 KiB
Groff
.\" Copyright (c) 1989, 1991, 1993, 1994
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
.\"
|
|
.\" This code is derived from software contributed to Berkeley by
|
|
.\" Guido van Rossum.
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the University of
|
|
.\" California, Berkeley and its contributors.
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" @(#)glob.3 8.3 (Berkeley) 4/16/94
|
|
.\"
|
|
.Dd April 16, 1994
|
|
.Dt GLOB 3
|
|
.Os
|
|
.Sh ̾¾Î
|
|
.Nm glob ,
|
|
.Nm globfree
|
|
.Nd ¥Ñ¥¿¡¼¥ó¤ËŬ¹ç¤¹¤ë¥Ñ¥¹Ì¾¤òÀ¸À®
|
|
.Sh ½ñ¼°
|
|
.Fd #include <glob.h>
|
|
.Ft int
|
|
.Fn glob "const char *pattern" "int flags" "int (*errfunc)(const char *, int)" "glob_t *pglob"
|
|
.Ft void
|
|
.Fn globfree "glob_t *pglob"
|
|
.Sh ²òÀâ
|
|
.Fn glob
|
|
´Ø¿ô¤Ï¡¢¥·¥§¥ë¤Ë¤è¤Ã¤Æ»ÈÍѤµ¤ì¤ë¥Õ¥¡¥¤¥ë̾¥Ñ¥¿¡¼¥ó¤Î¡¢Å¬¹çµ¬Â§¤ò
|
|
¼ÂÁõ¤¹¤ë¥Ñ¥¹Ì¾¥¸¥§¥Í¥ì¡¼¥¿¤Ç¤¹¡£
|
|
.Pp
|
|
¥¤¥ó¥¯¥ë¡¼¥É¥Õ¥¡¥¤¥ë
|
|
.Pa glob.h
|
|
¤Ï¡¢¾¯¤Ê¤¯¤È¤â¼¡¤Ë¼¨¤¹¥Õ¥£¡¼¥ë¥É¤¬´Þ¤Þ¤ì¤ë
|
|
¹½Â¤ÂÎ¥¿¥¤¥×
|
|
.Fa glob_t
|
|
¤òÄêµÁ¤·¤Þ¤¹¡£
|
|
.Bd -literal
|
|
typedef struct {
|
|
int gl_pathc; /* ¤³¤ì¤Þ¤Ç¤Î¹ç·×¥Ñ¥¹¥«¥¦¥ó¥È */
|
|
int gl_matchc; /* ¥Ñ¥¿¡¼¥ó¤ËŬ¹ç¤¹¤ë¥Ñ¥¹¥«¥¦¥ó¥È */
|
|
int gl_offs; /* gl_pathv¤ÎºÇ½é¤ËͽÌ󤵤ì¤ë¥Õ¥£¡¼¥ë¥É */
|
|
int gl_flags; /* ÊÖ¤µ¤ì¤ë¥Õ¥é¥° */
|
|
char **gl_pathv; /* ¥Ñ¥¿¡¼¥ó¤ËŬ¹ç¤¹¤ë¥Ñ¥¹¤Î¥ê¥¹¥È */
|
|
} glob_t;
|
|
.Ed
|
|
.Pp
|
|
°ú¿ô
|
|
.Fa pattern
|
|
¤ÏŸ³«¤¹¤ë¥Ñ¥¹Ì¾¥Ñ¥¿¡¼¥ó¤Î¥Ý¥¤¥ó¥¿¤Ç¤¹¡£
|
|
.Fn glob
|
|
°ú¿ô¤Ï¤½¤Î
|
|
¥Ñ¥¿¡¼¥ó¤ËÂФ·¤Æ¡¢¥¢¥¯¥»¥¹²Äǽ¤Ê¤¹¤Ù¤Æ¤Î¥Ñ¥¹Ì¾¤òÆͤ¹ç¤ï¤»
|
|
(
|
|
¥Þ¥Ã¥Á¥ó¥°
|
|
)
|
|
¡¢
|
|
Ŭ¹ç¤¹¤ë¥Ñ¥¹Ì¾¥ê¥¹¥È¤òºîÀ®¤·¤Þ¤¹¡£¥Ñ¥¹Ì¾¤Ë¥¢¥¯¥»¥¹¤¹¤ë¤¿¤á
|
|
.Fn glob
|
|
¤Ï¡¢¥Ñ¥¹
|
|
¤Î³Æ¹½À®Í×ÁÇ
|
|
(
|
|
ºÇ½ªÍ×ÁǤò½ü¤¯
|
|
)
|
|
¤Ç¤Î¸¡º÷µö²Ä¤È¡¢Æü쥥ã¥é¥¯¥¿
|
|
.Ql *
|
|
,
|
|
.Ql ?
|
|
¤Þ¤¿¤Ï
|
|
.Ql [
|
|
¤Ê¤É¤ò´Þ¤à
|
|
.Fa pattern
|
|
¤Î¡¢¤¹¤Ù¤Æ¤Î¥Õ¥¡¥¤¥ë̾¹½À®Í×Áǥǥ£¥ì¥¯¥È¥ê¤ÎÆɤß
|
|
¹þ¤ßµö²Ä¤òÍ׵ᤷ¤Þ¤¹¡£
|
|
.Pp
|
|
.Fn glob
|
|
°ú¿ô¤Ï¡¢Å¬¹ç¥Ñ¥¹Ì¾¤Î¿ô¤ò
|
|
.Fa gl_pathc
|
|
¥Õ¥£¡¼¥ë¥É¤Ë¡¢¥Ñ¥¹Ì¾¥Ý¥¤¥ó¥¿¥ê¥¹¥È
|
|
¤Î¥Ý¥¤¥ó¥¿¤ò
|
|
.Fa gl_pathv
|
|
¥Õ¥£¡¼¥ë¥É¤Ë¤½¤ì¤¾¤ìÊݸ¤·¤Þ¤¹¡£ºÇ½ª¥Ñ¥¹Ì¾¤Î¸å¤Î
|
|
ºÇ½é¤Î¥Ý¥¤¥ó¥¿¤Ï
|
|
.Dv NULL
|
|
¤Ç¤¹¡£¥Ñ¥¿¡¼¥ó¤ËŬ¹ç¤¹¤ë¥Ñ¥¹Ì¾¤¬³§Ìµ¤À¤Ã¤¿¾ì¹ç¡¢
|
|
ÊÖ¤µ¤ì¤ëŬ¹ç¥Ñ¥¹¤Î¿ô¤Ï¥¼¥í¤ËÀßÄꤵ¤ì¤Þ¤¹¡£
|
|
.Pp
|
|
.Fa pglob
|
|
¤Ç¼¨¤µ¤ì¤ë¹½Â¤ÂΤϸƤӽФ·¸µ¤¬ºîÀ®¤·¤Þ¤¹¡£
|
|
.Fa gl_pathv
|
|
¤Ç¼¨¤µ¤ì¤ë¥á¥â¥ê
|
|
¤Ê¤É¤Û¤«¤Î¶õ´Ö¤Ï¡¢
|
|
.Fn glob
|
|
´Ø¿ô¤¬É¬Íפ˱þ¤¸¤Æ³ä¤ê¿¶¤ê¤Þ¤¹¡£
|
|
.Pp
|
|
°ú¿ô
|
|
.Fa flags
|
|
¤Ï¡¢
|
|
.Fn glob
|
|
¤ÎµóÆ°¤òÊѹ¹¤¹¤ë¤¿¤á¤Ë»ÈÍѤ·¤Þ¤¹¡£
|
|
.Fa flags
|
|
¤ÎÃͤϡ¢
|
|
.Pa glob.h
|
|
¤ÇÄêµÁ¤µ¤ì¤Æ¤¤¤ë¼¡¤Ë¼¨¤¹ÃͤΤ½¤ì¤¾¤ì¥Ó¥Ã¥È¤´¤È¤ÎÊñ³çŪ
|
|
.Tn OR
|
|
¤Ç¤¹¡£
|
|
.Bl -tag -width GLOB_ALTDIRFUNC
|
|
.It Dv GLOB_APPEND
|
|
À¸À®¤µ¤ì¤¿¥Ñ¥¹Ì¾¤ò¡¢
|
|
.Fn glob
|
|
¤ËÂФ¹¤ëÁ°¤Î¸Æ¤Ó½Ð¤· ( ñ¿ô¤Þ¤¿¤ÏÊ£¿ô ) ¤ÇÀ¸À®¤µ¤ì¤¿¥Ñ¥¹Ì¾¤ËÄɲä·¤Þ¤¹¡£
|
|
.Fa gl_pathc
|
|
¤ÎÃͤϡ¢º£²ó¤Î¸Æ¤Ó½Ð¤·¤ª¤è¤ÓÁ°¤Î¸Æ¤Ó½Ð¤· ( ñ¿ô¤Þ¤¿¤ÏÊ£¿ô ) ¤Ç¤Î¡¢
|
|
Ŭ¹ç¥Ñ¥¹Ì¾¤Î¹ç·×¤Ë¤Ê¤ê¤Þ¤¹¡£Á°¤Î¸Æ¤Ó½Ð¤· ( ñ¿ô¤Þ¤¿¤ÏÊ£¿ô ) ¤Ë¤è¤Ã¤Æ
|
|
ÊÖ¤µ¤ì¤¿¥Ñ¥¹Ì¾¤Ë¡¢º£²óÀ¸À®¤µ¤ì¤¿¥Ñ¥¹Ì¾¤¬Äɲ䵤ì¤Þ¤¹¤¬¡¢
|
|
¥Þ¡¼¥¸ ( Ê»¹ç ) ¤Ï¤µ¤ì¤Þ¤»¤ó¡£Á°¤Î¸Æ¤Ó½Ð¤·¤Èº£²ó¤Î¸Æ¤Ó½Ð¤·¤Î¤¢¤¤¤À¤Ë¡¢
|
|
¸Æ¤Ó½Ð¤·¸µ¤Ï
|
|
.Dv GLOB_DOOFFS
|
|
¥Õ¥é¥°¤òÊѤ¨¤Æ¤Ï¤¤¤±¤Þ¤»¤ó¡£Æ±Íͤˡ¢
|
|
.Dv GLOB_DOOFFS
|
|
ÀßÄê»þ¤Î
|
|
.Fa gl_offs
|
|
¤ÎÃͤâÊѤ¨¤Æ¤Ï¤¤¤±¤Þ¤»¤ó¡£
|
|
( ¤â¤Á¤í¤ó )
|
|
.Fa pglob
|
|
¤Ë±Æ¶Á¤¹¤ë
|
|
.Fn globfree
|
|
¤Î¸Æ¤Ó½Ð¤·¤â¹Ô¤Ã¤Æ¤Ï¤Ê¤ê¤Þ¤»¤ó¡£
|
|
.It Dv GLOB_DOOFFS
|
|
.Fa gl_offs
|
|
¥Õ¥£¡¼¥ë¥É¤ò͸ú¤Ë¤·¤Þ¤¹¡£¤³¤Î¥Õ¥é¥°¤òÀßÄꤹ¤ë¤È¡¢
|
|
.Fa gl_pathv
|
|
¥Õ¥£¡¼¥ë¥É¤ÎÁ°¤ËÉղ乤ë
|
|
.Dv NULL
|
|
¥Ý¥¤¥ó¥¿¤Î¿ô¤¬¡¢
|
|
.Fa gl_offs
|
|
¤Ë¤è¤Ã¤Æ»ØÄê¤Ç¤¤Þ¤¹¡£¸À¤¤´¹¤¨¤ì¤Ð
|
|
.Fa gl_pathv
|
|
¤¬
|
|
.Fa gl_offs
|
|
¤Î
|
|
.Dv NULL
|
|
¥Ý¥¤¥ó¥¿¤ò¼¨¤·¡¢¤½¤Î¸å¤Ë
|
|
.Fa gl_pathc
|
|
¥Ñ¥¹Ì¾¥Ý¥¤¥ó¥¿¤¬Â³¤¡¢¤µ¤é¤Ë¤½¤Î¸å¤Ë
|
|
.Dv NULL
|
|
¥Ý¥¤¥ó¥¿¤¬Â³¤¤Þ¤¹¡£
|
|
.It Dv GLOB_ERR
|
|
¥ª¡¼¥×¥ó¤Þ¤¿¤ÏÆɤ߹þ¤ß¤Ç¤¤Ê¤¤¥Ç¥£¥ì¥¯¥È¥ê¤Ë½Ð²ñ¤Ã¤¿¾ì¹ç¡¢
|
|
.Fn glob
|
|
¤ò¥ê¥¿¡¼¥ó¤µ¤»¤Þ¤¹¡£Ä̾ï¤Ï¡¢
|
|
.Fn glob
|
|
¤¬Å¬¹ç¥Ñ¥¹Ì¾¸¡º÷¤ò³¹Ô¤·¤Þ¤¹¡£
|
|
.It Dv GLOB_MARK
|
|
.Fa pattern
|
|
¤ËŬ¹ç¤¹¤ë¥Ç¥£¥ì¥¯¥È¥ê¤Î³Æ¥Ñ¥¹Ì¾¤Ë¡¢¥¹¥é¥Ã¥·¥å¤ò
|
|
Éղä·¤Þ¤¹¡£
|
|
.It Dv GLOB_NOCHECK
|
|
.Fa pattern
|
|
¤ËŬ¹ç¤¹¤ë¥Ñ¥¹Ì¾¤¬³§Ìµ¤À¤Ã¤¿¾ì¹ç¡¢
|
|
.Fn glob
|
|
¤Ï
|
|
.Fa pattern
|
|
¤À¤±¤Ç¹½À®¤µ¤ì¤ë¥ê¥¹¥È¤òÊÖ¤·¤Þ¤¹¡£¥Ñ¥¹Ì¾¤Î¹ç·×¿ô¤Ï 1 ¤Ë¡¢Å¬¹ç
|
|
¥Ñ¥¹Ì¾¤Î¿ô¤Ï 0 ¤ËÀßÄꤵ¤ì¤Þ¤¹¡£
|
|
.Dv GLOB_QUOTE
|
|
¤¬ÀßÄꤵ¤ì¤Æ¤¤¤ì¤Ð¡¢ÊÖ¤µ¤ì¤ë¥Ñ¥¿¡¼¥ó¤Ë¤½¤Î¸ú²Ì¤¬È¿±Ç¤µ¤ì¤Þ¤¹¡£
|
|
.It Dv GLOB_NOSORT
|
|
¥Ç¥Õ¥©¥ë¥È¤Ç¥Ñ¥¹Ì¾¤Ï
|
|
.Tn ASCII
|
|
¾º½ç¤Ë¥½¡¼¥È¤µ¤ì¤Þ¤¹¡£¤³¤Î¥Õ¥é¥°¤Ï¤½¤¦¤·¤¿¥½¡¼¥È¡¢¤¹¤Ê¤ï¤Á¹â®²½
|
|
.Fn glob
|
|
µ¡Ç½¤ò˸¤²¤Þ¤¹¡£
|
|
.El
|
|
.Pp
|
|
¼¡¤Ë¼¨¤¹Ãͤâ
|
|
.Fa flags
|
|
¤Ë´Þ¤Þ¤ì¤ë¤³¤È¤Ï¤¢¤ê¤Þ¤¹¤¬¡¢¤³¤ì¤é¤Ï
|
|
.St -p1003.2
|
|
¤ÎÈóɸ½à³ÈÄ¥¤Ç¤¹¡£
|
|
.Bl -tag -width GLOB_ALTDIRFUNC
|
|
.It Dv GLOB_ALTDIRFUNC
|
|
pglob
|
|
¹½Â¤ÂΤμ¡¤Ë¼¨¤¹Äɲåե£¡¼¥ë¥É¤ò¡¢¥Ç¥£¥ì¥¯¥È¥ê¤Î¥ª¡¼¥×¥ó¡¢Æɤ߹þ¤ß¡¢
|
|
¥¯¥í¡¼¥º¤ª¤è¤Ó¡¢¤½¤ì¤é¥Ç¥£¥ì¥¯¥È¥ê¤Ç¸«ÉÕ¤«¤Ã¤¿¥Ñ¥¹Ì¾¤Î¥¹¥Æ¡¼¥¿¥¹¾ðÊó¼èÆÀ¤Ë
|
|
»ÈÍѤ¹¤ë¡¢ÂåÂØ glob ´Ø¿ô¤Ç½é´ü²½¤·¤Þ¤¹¡£
|
|
.Bd -literal
|
|
void *(*gl_opendir)(const char * name);
|
|
struct dirent *(*gl_readdir)(void *);
|
|
void (*gl_closedir)(void *);
|
|
int (*gl_lstat)(const char *name, struct stat *st);
|
|
int (*gl_stat)(const char *name, struct stat *st);
|
|
.Ed
|
|
.Pp
|
|
¥Æ¡¼¥×¤ËÊݸ¤µ¤ì¤¿¥Ç¥£¥ì¥¯¥È¥ê¤«¤é¡¢
|
|
.Xr restore 8
|
|
¤Î¤è¤¦¤Ê¥×¥í¥°¥é¥à¤Ë¤è¤Ã¤Æ
|
|
¥°¥í¥Ã¥Ó¥ó¥° ( ¥Õ¥¡¥¤¥ë̾Ÿ³« ) ¤Ç¤¤ë¤è¤¦¤Ë¡¢
|
|
¤³¤Î³ÈÄ¥¤¬ÍÑ°Õ¤µ¤ì¤Æ¤¤¤Þ¤¹¡£
|
|
.It Dv GLOB_BRACE
|
|
.Xr csh 1
|
|
¤Î¤è¤¦¤Ê
|
|
.Ql {pat,pat,...}
|
|
¥¹¥È¥ê¥ó¥°¤òŸ³«¤¹¤ë¤¿¤á¤Ë¡¢
|
|
¥Ñ¥¿¡¼¥ó¥¹¥È¥ê¥ó¥°¤òÁ°½èÍý¤·¤Þ¤¹¡£¥Ñ¥¿¡¼¥ó
|
|
.Ql {}
|
|
¤ÏÎò»ËŪÍýͳ ( ¤ª¤è¤Ó
|
|
.Xr find 1
|
|
¥Ñ¥¿¡¼¥ó¤ÎÆþÎϤòÍưפˤ¹¤ë¤¿¤á¤Ë¡¢
|
|
.Xr csh 1
|
|
¤¬Æ±¤¸¤³¤È¤ò¤¹¤ë¤È¤¤¤¦Íýͳ )
|
|
¤«¤é¡¢Ì¤Å¸³«¤Î¤Þ¤Þ»Ä¤µ¤ì¤Þ¤¹¡£
|
|
.It Dv GLOB_MAGCHAR
|
|
¥Ñ¥¿¡¼¥ó¤Ë
|
|
.Fn glob
|
|
ÍÑ¥¥ã¥é¥¯¥¿¤¬´Þ¤Þ¤ì¤Æ¤¤¤ë¤È¡¢
|
|
.Fn glob
|
|
´Ø¿ô¤Ë¤è¤Ã¤Æ¤³¤Î¥Õ¥é¥°¤¬ÀßÄꤵ¤ì¤Þ¤¹¡£¾ÜºÙ¤Ï
|
|
.Fa gl_matchc
|
|
¹½Â¤ÂÎ¥á¥ó¥Ð¤Î¡¢ÍÑË¡¤Ë¤Ä¤¤¤Æ¤ÎÀâÌÀ¤ò»²¾È¤·¤Æ¤¯¤À¤µ¤¤¡£
|
|
.It Dv GLOB_NOMAGIC
|
|
.Dv GLOB_NOCHECK
|
|
¤ÈƱ¤¸¤Ç¤¹¤¬¡¢Æü쥥ã¥é¥¯¥¿ ``*'', ``?''
|
|
¤Þ¤¿¤Ï ``['' ¤¬¤Ê¤Ë¤â´Þ¤Þ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ë¡¢¤³¤Î¥Õ¥é¥°¤Ï¤¿¤À
|
|
.Fa pattern
|
|
¤ò¸å¤ËÉղ乤ë¤À¤±¤Ç¤¹¡£
|
|
.Dv GLOB_NOMAGIC
|
|
¤Ï¡¢Îò»ËŪ¤Ê
|
|
.Xr csh 1
|
|
¤Ë¤è¤ë¥°¥í¥Ã¥Ó¥ó¥° ( ¥Õ¥¡¥¤¥ë̾Ÿ³« ) µóÆ°¤Î¼ÂÁõ¤òñ½ã²½¤¹¤ë¤¿¤á¤Ë
|
|
ÍÑ°Õ¤µ¤ì¤Æ¤¤¤Þ¤¹¡£¤½¤Î¾¤ÎÌÜŪ¤Ç¤Ï¤¿¤Ö¤ó¡¢
|
|
¤É¤ó¤Ê¾ì¹ç¤â»ÈÍѤ¹¤Ù¤¤Ç¤Ï¤¢¤ê¤Þ¤»¤ó¡£
|
|
.It Dv GLOB_QUOTE
|
|
¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å
|
|
.Pq Ql \e
|
|
¥¥ã¥é¥¯¥¿¤ò°úÍÑÉä¤È¤·¤Æ
|
|
͸ú¤Ë¤·¤Þ¤¹¡£¥Ñ¥¿¡¼¥ó¤Ë¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å¤È¤½¤ì¤Ë³¤¯¥¥ã¥é¥¯¥¿¤¬¤¢¤ë¾ì¹ç¡¢
|
|
¤½¤Î¥¥ã¥é¥¯¥¿¤òÆÃÊ̤˲ò¼á¤¹¤ë¤³¤È¤Ê¤¯¤½¤Î¤Þ¤Þ¤Î¥¥ã¥é¥¯¥¿¤È¤·¤Æ
|
|
ÃÖ´¹¤·¤Þ¤¹¡£
|
|
.It Dv GLOB_TILDE
|
|
.Ql ~
|
|
¤Ç»Ï¤Þ¤ë¥Ñ¥¿¡¼¥ó¤ò¡¢¥æ¡¼¥¶Ì¾¤Î¥Û¡¼¥à¥Ç¥£¥ì¥¯¥È¥ê¤Ë
|
|
Ÿ³«¤·¤Þ¤¹¡£
|
|
.El
|
|
.Pp
|
|
¸¡º÷¤Ë¤ª¤¤¤Æ¥ª¡¼¥×¥ó¤Þ¤¿¤ÏÆɤ߹þ¤ß¤Ç¤¤Ê¤¤¥Ç¥£¥ì¥¯¥È¥ê¤Ë½Ð²ñ¤Ã¤¿¾ì¹ç¡¢
|
|
.Fa errfunc
|
|
¤¬
|
|
.Pf non- Dv NULL
|
|
¤Ç¤Ê¤±¤ì¤Ð¡¢
|
|
.Fn glob
|
|
¤Ï
|
|
.Fa (*errfunc)(path, errno)
|
|
¤ò¸Æ¤Ó½Ð¤·¤Þ¤¹¡£
|
|
¤³¤ì¤ÏÈóľ´ÑŪ¤Ê¾ì¹ç¤¬¤¢¤ê¤Þ¤¹¡£
|
|
.Ql */Makefile
|
|
¤Î¤è¤¦¤Ê¥Ñ¥¿¡¼¥ó¤Ç¤Ï¡¢
|
|
.Ql foo
|
|
¤¬
|
|
¥Ç¥£¥ì¥¯¥È¤Ç¤Ê¤¯¤Æ¤â
|
|
.Ql foo/Makefile
|
|
¤Î
|
|
.Xr stat 2
|
|
¤¬»î¤ß¤é¤ì¤Æ¡¢
|
|
.Fa errfunc
|
|
¤ò
|
|
¸Æ¤Ó½Ð¤¹·ë²Ì¤Ë¤Ê¤ë¤«¤é¤Ç¤¹¡£
|
|
.Dv ENOENT
|
|
¤ª¤è¤Ó
|
|
.Dv ENOTDIR
|
|
¤Î¥Æ¥¹¥È¤Ë¤è¤Ã¤Æ¡¢
|
|
¥¨¥é¡¼¥ë¡¼¥Á¥ó¤Ï¤³¤ÎÆ°ºî¤òÍÞÀ©¤¹¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¤¬¡¢
|
|
¤½¤ì¤Ç¤â¤Ê¤ª¤³¤¦¤·¤¿¾ì¹ç¤Ë¤Ï
|
|
.Dv GLOB_ERR
|
|
¥Õ¥é¥°¤¬¤¿¤À¤Á¤Ë
|
|
.Fn glob
|
|
¤ò¥ê¥¿¡¼¥ó¤µ¤»¤Þ¤¹¡£
|
|
.Pp
|
|
.Fa errfunc
|
|
¤«¤éÈó¥¼¥í¤¬ÊÖ¤ë¤È
|
|
.Fn glob
|
|
¤ÏÁàºî¤òÄä»ß¤·¤Æ¡¢¤¹¤Ç¤ËŬ¹ç¤·¤¿¤¹¤Ù¤Æ¤Î
|
|
¥Ñ¥¹¤òÈ¿±Ç¤¹¤ë¤¿¤á¤Ë¡¢
|
|
.Fa gl_pathc
|
|
¤ª¤è¤Ó
|
|
.Fa gl_pathv
|
|
¤òÀßÄꤷ¤¿¸å¤Ç
|
|
.Dv GLOB_ABEND
|
|
¤òÊÖ¤·¤Þ¤¹¡£
|
|
¥¨¥é¡¼¤¬µ¯¤³¤ê
|
|
.Fa flags
|
|
¤Ë
|
|
.Dv GLOB_ERR
|
|
¤¬ÀßÄꤵ¤ì¤Æ¤¤¤ì¤Ð¡¢
|
|
.Fa errfunc
|
|
¤ò¸Æ¤Ó½Ð¤·¤¿¾ì¹ç¤½¤ÎÌá¤êÃͤ˴ط¸¤Ê¤¯¡¢Æ±¤¸¤³¤È¤¬µ¯¤³¤ê¤Þ¤¹¡£
|
|
.Dv GLOB_ERR
|
|
¤ò̤ÀßÄê¤Ç¡¢
|
|
.Fa errfunc
|
|
¤¬
|
|
.Dv NULL
|
|
¤«¤Þ¤¿¤Ï
|
|
.Fa errfunc
|
|
¤¬¥¼¥í¤òÊÖ¤·¤¿¾ì¹ç¡¢¥¨¥é¡¼¤Ï̵»ë¤µ¤ì¤Þ¤¹¡£
|
|
.Pp
|
|
.Fn globfree
|
|
´Ø¿ô¤Ï¡¢Á°¤Î
|
|
.Fn glob
|
|
¸Æ¤Ó½Ð¤·¤Ë¤è¤Ã¤Æ
|
|
.Fa pglob
|
|
¤È
|
|
´ØÏ¢¤·¤¿¡¢¤¹¤Ù¤Æ¤Î¶õ´Ö¤ò²òÊü¤·¤Þ¤¹¡£
|
|
.Sh Ìá¤êÃÍ
|
|
̵»ö¤Ë´°Î»¤·¤¿¾ì¹ç
|
|
.Fn glob
|
|
¤Ï¥¼¥í¤òÊÖ¤·¤Þ¤¹¡£¤µ¤é¤Ë¡¢
|
|
.Fa pglob
|
|
¤Î³Æ¥Õ¥£¡¼¥ë¥É
|
|
¤Ë¤Ï¼¡¤Ë¼¨¤¹Ãͤ¬´Þ¤Þ¤ì¤Þ¤¹¡£
|
|
.Bl -tag -width GLOB_NOCHECK
|
|
.It Fa gl_pathc
|
|
¤³¤ì¤Þ¤Ç¤ÎŬ¹ç¥Ñ¥¹Ì¾¤Î¹ç·×¿ô¤¬´Þ¤Þ¤ì¤Þ¤¹¡£
|
|
.Dv GLOB_APPEND
|
|
¤¬»ØÄꤵ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢Á°¤Î
|
|
.Fn glob
|
|
µ¯Æ°¤ÇÆÀ¤é¤ì¤¿¤Û¤«¤ÎŬ¹ç¥Ñ¥¹Ì¾¤Î¿ô¤â¡¢
|
|
¤³¤Î¹ç·×¤Ë¤Ï´Þ¤ì¤Þ¤¹¡£
|
|
.It Fa gl_matchc
|
|
¸½ºß¤Î
|
|
.Fn glob
|
|
µ¯Æ°¤Ë¤è¤Ã¤ÆÆÀ¤é¤ì¤¿Å¬¹ç¥Ñ¥¹Ì¾¤Î¿ô¤¬
|
|
´Þ¤Þ¤ì¤Þ¤¹¡£
|
|
.It Fa gl_flags
|
|
.Fa pattern
|
|
¤ËÆü쥥ã¥é¥¯¥¿ ``*'', ``?'', ¤Þ¤¿¤Ï ``['' ¤Î¤É¤ì¤«¤¬´Þ¤Þ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢
|
|
.Dv GLOB_MAGCHAR
|
|
¤¬ÀßÄꤷ¤¿¥Ó¥Ã¥È¤ò»ý¤Ä
|
|
.Fa flags
|
|
¥Ñ¥é¥á¡¼¥¿¤Î
|
|
¥³¥Ô¡¼¤¬´Þ¤Þ¤ì¤Þ¤¹¡£Æü쥥ã¥é¥¯¥¿¤¬´Þ¤Þ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢¤³¤Î¥Õ¥£¡¼¥ë¥É¤Î
|
|
ÆâÍƤϥ¯¥ê¥¢¤µ¤ì¤Þ¤¹¡£
|
|
.It Fa gl_pathv
|
|
Ŭ¹ç¥Ñ¥¹Ì¾¤Î
|
|
.Dv NULL
|
|
¤Ç½ª¤ï¤ë¥ê¥¹¥È¤Î¥Ý¥¤¥ó¥¿¤¬´Þ¤Þ¤ì¤Þ¤¹¡£
|
|
¤¿¤À¤·¡¢¤â¤·
|
|
.Fa gl_pathc
|
|
¤¬¥¼¥í¤Ê¤é¤Ð¡¢
|
|
.Fa gl_pathv
|
|
¤ÎÆâÍƤÏÄêµÁ¤µ¤ì¤Þ¤»¤ó¡£
|
|
.El
|
|
.Pp
|
|
¥¨¥é¡¼¤Î¤¿¤á½ªÎ»¤¹¤ë¤È
|
|
.Fn glob
|
|
¤Ï
|
|
errno
|
|
¤òÀßÄꤷ¤Æ¡¢¼¡¤Ë¼¨¤¹Èó¥¼¥íÄê¿ô¤Î
|
|
1 ¤Ä¤òÊÖ¤·¤Þ¤¹¡£¤³¤ì¤é¤ÎÄê¿ô¤Ï¡¢¥¤¥ó¥¯¥ë¡¼¥É¥Õ¥¡¥¤¥ë
|
|
.Aq Pa glob.h
|
|
¤ÇÄêµÁ¤µ¤ì¤Þ¤¹¡£
|
|
.Bl -tag -width GLOB_NOCHECK
|
|
.It Dv GLOB_NOSPACE
|
|
¥á¥â¥ê³ä¤êÅö¤Æ¤Î»î¤ß¤¬¼ºÇÔ¤·¤Þ¤·¤¿¡£
|
|
.It Dv GLOB_ABEND
|
|
¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾å¤Ë
|
|
.Dv GLOB_ERR
|
|
¤¬ÀßÄꤵ¤ì¤Æ¤¤¤¿¤«¡¢¤Þ¤¿¤Ï
|
|
.Fa (*errfunc)()
|
|
¤¬Èó¥¼¥í¤òÊÖ¤·¤¿¤Î¤Ç¡¢
|
|
.Fn glob
|
|
¤Ï¥Ñ¥¹Ì¾¤ÎÁöºº¤òÄä»ß¤·¤Þ¤·¤¿¡£
|
|
.El
|
|
.Pp
|
|
°ú¿ô
|
|
.Fa pglob\->gl_pathc
|
|
¤ª¤è¤Ó
|
|
.Fa pglob\->gl_pathv
|
|
¤Ï°ÍÁ³¤È¤·¤Æ¡¢¾å¤Ç
|
|
»ØÄê¤Î¤È¤ª¤ê¤ËÀßÄꤵ¤ì¤¿¤Þ¤Þ¤Ç¤¹¡£
|
|
.Sh Îã
|
|
.Ql "ls -l *.c *.h"
|
|
¤ÎÂçÂΤÎÅù²Á¤Ï¡¢¼¡¤Ë¼¨¤¹¥³¡¼¥É¤Ç¼èÆÀ¤¹¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
|
|
.Bd -literal -offset indent
|
|
glob_t g;
|
|
|
|
g.gl_offs = 2;
|
|
glob("*.c", GLOB_DOOFFS, NULL, &g);
|
|
glob("*.h", GLOB_DOOFFS | GLOB_APPEND, NULL, &g);
|
|
g.gl_pathv[0] = "ls";
|
|
g.gl_pathv[1] = "-l";
|
|
execvp("ls", g.gl_pathv);
|
|
.Ed
|
|
.Sh ´ØÏ¢¹àÌÜ
|
|
.Xr sh 1 ,
|
|
.Xr fnmatch 3 ,
|
|
.Xr regexp 3
|
|
.Sh µ¬³Ê
|
|
.Fn glob
|
|
´Ø¿ô¤Ë¤Ï¼¡¤Ë¼¨¤¹Îã³°¤ò½ü¤¤¤Æ¡¢
|
|
.St -p1003.2
|
|
¤È¤Î¸ß´¹À¤¬´üÂÔ¤µ¤ì¤Æ¤¤¤Þ¤¹¡£Îã³°¤Ï¥Õ¥é¥°
|
|
.Dv GLOB_ALTDIRFUNC,
|
|
.Dv GLOB_BRACE
|
|
.Dv GLOB_MAGCHAR,
|
|
.Dv GLOB_NOMAGIC,
|
|
.Dv GLOB_QUOTE,
|
|
¤ª¤è¤Ó
|
|
.Dv GLOB_TILDE,
|
|
¤½¤ì¤Ë¥Õ¥£¡¼¥ë¥É
|
|
.Fa gl_matchc
|
|
¤ª¤è¤Ó
|
|
.Fa gl_flags
|
|
¤Ê¤É¤ò¡¢¸·Àµ¤Ê
|
|
.Tn POSIX
|
|
½àµò¤òÁ褦¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ç¤Ï»ÈÍѤ¹¤Ù¤¤Ç¤Ï¤Ê¤¤¤È¤¤¤¦¤³¤È¤Ç¤¹¡£
|
|
.Sh Îò»Ë
|
|
.Fn glob
|
|
¤ª¤è¤Ó
|
|
.Fn globfree
|
|
´Ø¿ô¤Ï¡¢
|
|
.Bx 4.4
|
|
¤ÇºÇ½é¤Ë¼è¤êÆþ¤ì¤é¤ì¤Þ¤·¤¿¡£
|
|
.Sh ¥Ð¥°
|
|
.Dv MAXPATHLEN
|
|
¤è¤ê¤âŤ¤¥Ñ¥¿¡¼¥ó¤Ï¡¢Ìµ¸¡ºº¥¨¥é¡¼¤Î¸¶°ø¤È¤Ê¤ë²ÄǽÀ¤¬¤¢¤ê¤Þ¤¹¡£
|
|
.Pp
|
|
.Fn glob
|
|
°ú¿ô¤Ï¼ºÇÔ¤·¤Æ¡¢¥é¥¤¥Ö¥é¥ê¥ë¡¼¥Á¥ó
|
|
.Xr stat 2 ,
|
|
.Xr closedir 3 ,
|
|
.Xr opendir 3 ,
|
|
.Xr readdir 3 ,
|
|
.Xr malloc 3 ,
|
|
¤ª¤è¤Ó
|
|
.Xr free 3
|
|
ÍѤ˻ØÄꤷ¤¿¥¨¥é¡¼¤Î¤É¤ì¤«¤Ë¡¢ errno ¤òÀßÄꤹ¤ë¤³¤È¤¬¤¢¤ê¤Þ¤¹¡£
|