.\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl)
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
.\" USA.
.\"
.\" Japanese Version Copyright (c) 2004 Yuichi SATO
.\"         all rights reserved.
.\" Translated Sun Sep 12 05:05:19 JST 2004
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
.TH WORDEXP 3 2008-07-14  "" "Linux Programmer's Manual"
.SH ̾
wordexp, wordfree \- posix Τ褦ñŸԤ
.SH 
.B "#include <wordexp.h>"
.sp
.BI "int wordexp(const char *" s ", wordexp_t *" p ", int " flags );
.sp
.BI "void wordfree(wordexp_t *" p );
.sp
.in -4n
glibc εǽޥ׷
.RB ( feature_test_macros (7)
):
.in
.sp
.BR wordexp (),
.BR wordfree ():
_XOPEN_SOURCE
.SH 
ؿ
.BR wordexp ()
ϥΤ褦ʸ
.I s
Ÿ
.I p
ǻؤ¤Τ˷̤֤
ǡ
.I wordexp_t
ϾʤȤե
.IR we_wordc ,
.IR we_wordv ,
.I we_offs
ŤΤǤ롣
ե
.I we_wordc

.I size_t
Ǥꡢ
.I s
Ÿ̤ñ줬Ĥ뤫ɽ
ե
.I we_wordv

.I char **
ǤꡢĤäñؤ
.I size_t
Υե
.I we_offs
ϡ
.I we_wordv
ˤǤΤĤ
NULL ٤ɽΤ˻Ȥ줿ꤹ
.RI ( flags
ˤꤵ롣򻲾ȡ)
.LP
ؿ
.BR wordfree ()
ϳƤٲ롣
ΤˤȡδؿϤΰΤǤϤʤ

.I we_wordv
Ȥ줬ؤʸ롣
.SS "ʸ"
Ÿϥˤ륳ޥɤΥѥ᡼Ÿ
.RB ( sh (1)
򻲾) ƱǤΤǡʸ
.I s
ϥ륳ޥɥѥ᡼ȤʸޤǤϤʤʤ
ä˥פƤʤԡ|, &, ;, <, >, (, ), {, } ʸ
ޥִѥ᡼ִξ̰ʳ˴ޤƤϤʤʤ
.LP

.I s
˥ȤƤʤʸ # ǻϤޤñ줬ޤޤƤˤϡ
ñȤʹߤñ줬̵뤵뤫
Ȥ # ʸȤưʤϡꤵƤʤ
.SS "Ÿ"
¹ԤŸϡʲʳǹ:
Ÿ (~user  user Υۡǥ쥯ȥ֤)
ѿŸ ($FOO Ķѿ FOO ֤ͤ)
ޥŸ ($(command) ޤ \`command\`  command νϤ֤)
Ÿեʬ䡢磻ɥŸȤν
.LP
üʥѥ᡼ ($@, $*, $#, $?, $\-, $$, $!, $0) 
Ÿ̤ϵꤵƤʤ
.LP
եʬϴĶѿ $IFS ѤƹԤ롣
δĶѿꤵƤʤ硢
եɶڤʸϥڡ֡ԤǤ롣
.SS "Ϥ"

.I we_wordv
ϸĤäñޤߡǸ NULL ³
.SS "flags "
.I flags
ϰʲͤΥӥåŪ OR Ǥ:
.TP
.B WRDE_APPEND
ĤäñθƤӽФ̤ɲä롣
.TP
.B WRDE_DOOFFS
֤Ǥ
.I we_offs
Ĥ NULL 
.I we_wordv
 (֤
.I we_wordc
ˤϥȤʤ)
.TP
.B WRDE_NOCMD
ޥִԤʤ
.TP
.B WRDE_REUSE

.I p

.BR wordexp ()
θƤӽФ̤Ǥꡢ
.BR wordfree ()
 (ޤ) ƤӽФʤ
Ƥ줿ΰѤ롣
.TP
.B WRDE_SHOWERR
̾ϥޥִΤȤ
.I stderr

.I /dev/null
˥쥯Ȥ롣
Υե饰
.I stderr
쥯Ȥʤ褦˻ꤹ롣
.TP
.B WRDE_UNDEF
̤ΥѿŸ褦Ȥˡ顼Ȥư
.SH ֤
 0 ֤롣
顼ξϰʲ 5 ĤͤΤ 1 Ĥ֤롣
.TP
.B WRDE_BADCHAR
Ԥޤ |, &, ;, <, >, (, ), {, } Τ 1 Ĥ˽и
.TP
.B WRDE_BADVAL
̤ΥѿȤ졢
.B WRDE_UNDEF
ե饰Ǥ򥨥顼Ȥư褦˻ؼƤ롣
.TP
.B WRDE_CMDSUB
ޥִꡢ
.B WRDE_NOCMD
ե饰Ǥ򥨥顼Ȥư褦˻ؼƤ롣
.TP
.B WRDE_NOSPACE
꤬­ʤ
.TP
.B WRDE_SYNTAX
б̤ʤȤפʤȤä
ν񼰥顼
.SH С
.BR wordexp ()

.BR wordfree ()
ϡС 2.1 ʹߤ glibc 󶡤Ƥ롣
.SH 
POSIX.1-2001.
.SH 
ʲΥץץνϤϤ "ls [a-c]*.c" Ʊˤʤ롣
.LP
.nf
#include <stdio.h>
#include <stdlib.h>
#include <wordexp.h>

int
main(int argc, char **argv)
{
    wordexp_t p;
    char **w;
    int i;

    wordexp("[a-c]*.c", &p, 0);
    w = p.we_wordv;
    for (i = 0; i < p.we_wordc; i++)
        printf("%s\en", w[i]);
    wordfree(&p);
    exit(EXIT_SUCCESS);
}
.fi
.SH Ϣ
.BR fnmatch (3),
.BR glob (3)