wordexp - ライブラリコールの説明 - Linux コマンド集 一覧表

wordexp, wordfree - posix シェルのように単語の展開を行う

"#include <wordexp.h>"
int wordexp(const char * s , wordexp_t * p , int flags );
void wordfree(wordexp_t * p );

関数 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 とそれが指し示す文字列を解放する。

最初に簡単な例を示す。 出力はだいたい "ls [a-c]*.c" と同じになる。

#include <stdio.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);
        return 0;
}

文字列引き数

展開

出力される配列

flags 引き数

成功した場合は 0 が返される。 エラーの場合は以下の 5 つの値のうちの 1 つが返される。

WRDE_BADCHAR

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

WRDE_BADVAL

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

WRDE_CMDSUB

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

WRDE_NOSPACE

メモリが足りない。

WRDE_SYNTAX

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

POSIX.1-2001

  fnmatch (3),   glob (3)