# gfs_glob

## Name

gfs_glob -- パターンにマッチするパス名を取得する

## Synopsis

    #include <gfarm/gfarm.h>

```char *gfs_glob``(const char * `pattern`, gfarm_stringlist * `paths`, gfs_glob_t * `types`);`

## DESCRIPTION

ワイルドカードを含む引数 `pattern` にマッチする全てのパス名を `paths` に返します。

返された個々のパス名を参照するには、 gfarm_stringlist_length(3)、 gfarm_stringlist_elem(3) を使います。

gfs_glob(3) を使用する前に、引数 `types` が指す領域をgfs_glob_init(3) で動的に確保し、 使用後 gfs_glob_free(3) で解放する必要があります。

## RETURN VALUES

`NULL`

  正常終了を示します。

`GFARM_ERR_NO_MEMORY`

  メモリ不足のため処理を中止しました。

`GFARM_ERR_PATHNAME_TOO_LONG`

  パターンあるいはパス名が長すぎて処理できませんでした。

その他

  上記以外のエラーが生じたことを示します。

## SEE ALSO

gfs_glob_init(3) gfs_glob_free(3) gfarm_stringlist_init(3) gfarm_stringlist_length(3) gfarm_stringlist_elem(3) gfarm_stringlist_free(3) gfarm_stringlist_free_deeply(3)