WORDEXP

名前

書式

int wordexp(const char *s, wordexp_t *p, int flags);

void wordfree(wordexp_t *p);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

wordexp(), wordfree(): _XOPEN_SOURCE  

説明

関数 wordfree() は割り当てたメモリを再度解放する。 より正確にいうと、この関数はその引き数を解放するのではなく、 配列 we_wordv とそれが指し示す文字列を解放する。  

例

#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);
}

文字列引き数

引き数 s にクォートしていないコメント文字 # で始まる単語が含まれている場合には、 その単語とそれ以降の単語が無視されるか、 それとも # がコメント文字として扱わないかは、規定されていない。  

展開

特殊なパラメータ ($@, $*, $#, $?, $-, $$, $!, $0) の 展開結果は規定されていない。

フィールド分割は環境変数 $IFS を用いて行われる。 この環境変数が設定されていない場合、 フィールド区切り文字はスペース・タブ・改行である。  

出力される配列

flags 引き数

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

未定義のシェル変数を展開しようとした場合に、エラーとして扱う。

返り値

WRDE_BADCHAR

改行または |, &, ;, <, >, (, ), {, } のうちの 1 つが不正に出現した。

WRDE_BADVAL

未定義のシェル変数が参照され、かつ WRDE_UNDEF フラグでこれをエラーとして扱うように指示されている。

WRDE_CMDSUB

コマンド置換が起こり、かつ WRDE_NOCMD フラグでこれをエラーとして扱うように指示されている。

WRDE_NOSPACE

メモリが足りない。

WRDE_SYNTAX

対応する括弧がない、クォートが合致しないといった、 シェルの書式エラー。

準拠

関連項目

Index

名前

書式

説明

例

文字列引き数

展開

出力される配列

flags 引き数

返り値

準拠

関連項目