Provided by: manpages-ja-dev_0.5.0.0.20161015+dfsg-1_all
名前
wordexp, wordfree - posix シェルのように単語の展開を行う
書式
#include <wordexp.h> int wordexp(const char *s, wordexp_t *p, int flags); void wordfree(wordexp_t *p); glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照): wordexp(), wordfree(): _XOPEN_SOURCE
説明
関数 wordexp() はシェルのように文字列 s を展開し、 p で指し示す構造体に結果を返す。 デー タ型 wordexp_t は少なくともフィールド we_wordc, we_wordv, we_offs を持つ構造体である。 フィールド we_wordc は size_t であり、 s を展開した結果に単語がいくつあるかを表す。 フィー ルド we_wordv は char ** であり、見つかった単語の配列を指し示す。 size_t 型のフィールド we_offs は、 we_wordv 配列にある初期要素のうちいくつが NULL で埋められるべきかを表すのに使 われたりする (flags により決定される。下記を参照。)。 関数 wordfree() は割り当てたメモリーを再度解放する。 より正確にいうと、この関数はその引き 数を解放するのではなく、 配列 we_wordv とそれが指し示す文字列を解放する。 文字列引き数 この展開はシェルによるコマンドのパラメーターの展開 (sh(1) を参照) と同じであるので、文字 列 s はシェルコマンドパラメーターで不正とされる文字を含んではならない。 特にエスケープされ ていない改行、|, &, ;, <, >, (, ), {, } 文字を コマンド置換やパラメーター置換の場面以外に 含めてはならない。 引き数 s にクォートしていないコメント文字 # で始まる単語が含まれている場合には、 その単語 とそれ以降の単語が無視されるか、 それとも # がコメント文字として扱わないかは、規定されてい ない。 展開 実行される展開は、以下の段階で構成される: チルダ展開 (~user を user のホームディレクトリに 置き換える)、 変数展開 ($FOO を環境変数 FOO の値に置き換える)、 コマンド展開 ($(command) または `command` を command の出力で置き換える)、 算術展開、フィールド分割、ワイルドカード 展開、クォートの除去。 特殊なパラメーター ($@, $*, $#, $?, $-, $$, $!, $0) の 展開結果は規定されていない。 フィールド分割は環境変数 $IFS を用いて行われる。 この環境変数が設定されていない場合、 フィールド区切り文字はスペース・タブ・改行である。 出力される配列 配列 we_wordv は見つかった単語をを含み、最後に NULL が続く。 flags 引き数 flags 引き数は以下の値のビット包含的 OR である: WRDE_APPEND 見つかった単語を前回の呼び出し結果の配列に追加する。 WRDE_DOOFFS 初期状態である we_offs 個の NULL を配列 we_wordv に挿入する (これらは返される we_wordc にはカウントされない)。 WRDE_NOCMD コマンド置換を行わない。 WRDE_REUSE 引き数 p は前回の wordexp() の呼び出し結果であり、 wordfree() が (まだ) 呼び出さ れない。 割り当てられた領域を再利用する。 WRDE_SHOWERR 通常はコマンド置換のときに stderr が /dev/null にリダイレクトされる。 このフラグは stderr をリダイレクトしないように指定する。 WRDE_UNDEF 未定義のシェル変数を展開しようとした場合に、エラーとして扱う。
返り値
成功した場合は 0 が返される。 エラーの場合は以下の 5 つの値のうちの 1 つが返される。 WRDE_BADCHAR 改行または |, &, ;, <, >, (, ), {, } のうちの 1 つが不正に出現した。 WRDE_BADVAL 未定義のシェル変数が参照され、かつ WRDE_UNDEF フラグでこれをエラーとして扱うように 指示されている。 WRDE_CMDSUB コマンド置換が要求されたが、 WRDE_NOCMD フラグでこれをエラーとして扱うように指示さ れていた。 WRDE_NOSPACE メモリーが足りない。 WRDE_SYNTAX 対応する括弧がない、クォートが合致しないといった、 シェルの書式エラー。
バージョン
wordexp() と wordfree() は、バージョン 2.1 以降の glibc で提供されている。
準拠
POSIX.1-2001.
例
以下のサンプルプログラムの出力はだいたい "ls [a-c]*.c" と同じになる。 #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\n", w[i]); wordfree(&p); exit(EXIT_SUCCESS); }
関連項目
fnmatch(3), glob(3)
この文書について
この man ページは Linux man-pages プロジェクトのリリース 3.79 の一部 である。プロジェクト の説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。 2014-12-31 WORDEXP(3)