.\" Expanded the description of various flags
.\" Various wording fixes.
.\"
-.\" Japanese Version Copyright (c) 1998 Ken Wakasa all rights reserved.
-.\" Translated 1998-06-24, Ken Wakasa <wakasa@iname.com>
-.\" Updated 1999-01-04, Kentaro Shirakata <argrath@yo.rim.or.jp>
-.\" Updated 2008-02-12, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.77
+.\"*******************************************************************
.\"
-.TH GLOB 3 2007-10-10 "GNU" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH GLOB 3 2007\-10\-10 GNU "Linux Programmer's Manual"
.SH 名前
-glob, globfree \- パターンにマッチするパス名を見付ける。glob() によっ
-て確保されたメモリ領域を解放する。
+glob, globfree \- パターンにマッチするパス名を見付ける。glob() によっ て確保されたメモリ領域を解放する。
.SH 書式
.nf
-.B #include <glob.h>
+\fB#include <glob.h>\fP
.sp
-.BI "int glob(const char *" pattern ", int " flags ,
+\fBint glob(const char *\fP\fIpattern\fP\fB, int \fP\fIflags\fP\fB,\fP
.br
-.BI " int (*" errfunc ") (const char *" epath ", int " eerrno ),
+\fB int (*\fP\fIerrfunc\fP\fB) (const char *\fP\fIepath\fP\fB, int \fP\fIeerrno\fP\fB),\fP
.br
-.BI " glob_t *" pglob );
+\fB glob_t *\fP\fIpglob\fP\fB);\fP
.br
-.BI "void globfree(glob_t *" pglob );
+\fBvoid globfree(glob_t *\fP\fIpglob\fP\fB);\fP
.fi
.SH 説明
-.BR glob ()
-関数はシェルが用いているルール
-.RB ( glob (7)
-参照) に基づいてパターン
-.I pattern
-にマッチするすべてのパス名を検索する。
-チルダ (~) の展開やパラメータ置換は行われない。それらを行いたい場合は
-.BR wordexp (3)
+\fBglob\fP() 関数はシェルが用いているルール (\fBglob\fP(7) 参照) に基づいてパターン \fIpattern\fP
+にマッチするすべてのパス名を検索する。 チルダ (~) の展開やパラメータ置換は行われない。それらを行いたい場合は \fBwordexp\fP(3)
を使うとよい。
.PP
-.BR globfree ()
-関数は前に呼ばれた
-.BR glob ()
-により動的に確保された記憶領域を解放する。
+\fBglobfree\fP() 関数は前に呼ばれた \fBglob\fP() により動的に確保された記憶領域を解放する。
.PP
-.BR glob ()
-の結果は
-.I pglob
-がポイントする構造体に返される。
-.I pglob
-は
-.I glob_t
-型の構造体である。
-.I glob_t
-型は
-.I <glob.h>
-内で宣言されており、以下の要素を含んでいる。これらの要素は POSIX.2 で定義
+\fBglob\fP() の結果は \fIpglob\fP がポイントする構造体に返される。 \fIpglob\fP は \fIglob_t\fP 型の構造体である。
+\fIglob_t\fP 型は \fI<glob.h>\fP 内で宣言されており、以下の要素を含んでいる。これらの要素は POSIX.2 で定義
されている (さらに多くの要素が拡張として入っているかもしれない)。
.PP
.br
.PP
結果は動的に確保された記憶領域に入れられる。
.PP
-パラメータ
-.I flags
-には以下の示す定数のうち、指定したいものをビットごとの OR で与える
-(一つも
-指定しなくてもよい)。これによって
-.BR glob ()
-の動作を変更できる。
-.TP
-.B GLOB_ERR
-(例えば、ディレクトリに読み取り許可属性が無い場合などで)
-読み取りエラーが発生した際に関数から戻る。
-デフォルトでは、エラーに関わらず
+パラメータ \fIflags\fP には以下の示す定数のうち、指定したいものをビットごとの OR で与える (一つも 指定しなくてもよい)。これによって
+\fBglob\fP() の動作を変更できる。
+.TP
+\fBGLOB_ERR\fP
+(例えば、ディレクトリに読み取り許可属性が無い場合などで) 読み取りエラーが発生した際に関数から戻る。 デフォルトでは、エラーに関わらず
読み取り可能なディレクトリを全てについて読み取りを実行しようとする。
-.TP
-.B GLOB_MARK
+.TP
+\fBGLOB_MARK\fP
ディレクトリに対応する各々のパスにスラッシュを付加する。
-.TP
-.B GLOB_NOSORT
-返されるパス名のソートを行わない。
-ソートを行わない理由は、処理時間を節約するためだけである。
-デフォルトでは、返されるパス名はソートされる。
-.TP
-.B GLOB_DOOFFS
-.I pglob->pathv
-の文字列リストの先頭に
-.I pglob->gl_offs
-スロット分の領域を予約する。
+.TP
+\fBGLOB_NOSORT\fP
+返されるパス名のソートを行わない。 ソートを行わない理由は、処理時間を節約するためだけである。 デフォルトでは、返されるパス名はソートされる。
+.TP
+\fBGLOB_DOOFFS\fP
+\fIpglob\->pathv\fP の文字列リストの先頭に \fIpglob\->gl_offs\fP スロット分の領域を予約する。
予約されたスロットには NULL ポインタが入る。
-.TP
-.B GLOB_NOCHECK
-マッチするパターンがなければ、元のパターンを返す。
-デフォルトでは、
-.BR glob ()
-はマッチするパターンがなければ
-.B GLOB_NOMATCH
-を返す。
-.TP
-.B GLOB_APPEND
-この呼び出しでの結果を直前の
-.BR glob ()
-の呼び出しで返された結果のベクトルに追加する。最初の
-.BR glob ()
+.TP
+\fBGLOB_NOCHECK\fP
+マッチするパターンがなければ、元のパターンを返す。 デフォルトでは、 \fBglob\fP() はマッチするパターンがなければ
+\fBGLOB_NOMATCH\fP を返す。
+.TP
+\fBGLOB_APPEND\fP
+この呼び出しでの結果を直前の \fBglob\fP() の呼び出しで返された結果のベクトルに追加する。最初の \fBglob\fP()
の呼び出しの際にはこのフラグを設定してはいけない。
-.TP
-.B GLOB_NOESCAPE
-バックスラッシュ (\(aq\\\(aq) をエスケープ用文字として使用できない。
-通常は、バックスラッシュを使って、次に続く文字をクォートすることで、
+.TP
+\fBGLOB_NOESCAPE\fP
+バックスラッシュ (\(aq\e\(aq) をエスケープ用文字として使用できない。 通常は、バックスラッシュを使って、次に続く文字をクォートすることで、
特別な意味を持つメタキャラクタを無効することができる。
.PP
-.I flags
-には以下に示すものも指定できる。
-これらは GNU で拡張されたもので、POSIX.2 では定義されていない。
-.TP
-.B GLOB_PERIOD
-先頭のピリオドがメタキャラクタにマッチできるようにする。
-デフォルトでは、メタキャラクタは先頭のピリオドにはマッチできない。
-.TP
-.B GLOB_ALTDIRFUNC
-ファイルシステムにアクセスする際に、通常のライブラリ関数の代わりに
-代替関数
-.IR pglob\->gl_closedir ,
-.IR pglob\->gl_readdir ,
-.IR pglob\->gl_opendir ,
-.IR pglob\->gl_lstat ,
-.I pglob\->gl_stat
-が用いられる。
-.TP
-.B GLOB_BRACE
-\fB{a,b}\fR
-という形式の
-.BR csh (1)
-スタイルの括弧表現を展開する。
-括弧表現は入れ子にすることができる。
-したがって、例えば、"{foo/{,cat,dog},bar}" というパターンを
-指定した場合に得られる結果は、
-4つの文字列 "foo/", "foo/cat", "foo/dog", "bar" のそれぞれについて
-.BR glob ()
-を呼び出した場合と同じになる。
-.TP
-.B GLOB_NOMAGIC
-パターンにメタキャラクタが含まれていない場合、
-マッチ結果として指定されたパターンだけを返す。
-パターンで指定された名前のファイルが存在しない場合であっても、
-そのパターンが返される。
-.TP
-.B GLOB_TILDE
-チルダの展開を行う。
-チルダ (\(aq~\(aq) がパターン内の唯一の文字の場合か、先頭のチルダの直後の文字が
-スラッシュ (\(aq/\(aq) の場合、チルダを呼び出し者のホームディレクトリで置換する。
-先頭のチルダにユーザ名が続く場合 (例えば "~andrea/bin")、
-チルダとユーザ名をそのユーザのホームディレクトリで置換する。
-ユーザ名が無効な場合やホームディレクトリが決定できない場合は、
-置換は実行されない。
-.TP
-.B GLOB_TILDE_CHECK
-このフラグを指定すると
-.B GLOB_TILDE
-と同様の振舞いをする。
-.B GLOB_TILDE
-との違いは、ユーザ名が無効だった場合や
-ホームディレクトリが決定できなかった場合に、
-パターン自身を使用するのではなく、
-.BR glob ()
-がエラーを示す
-.B GLOB_NOMATCH
+\fIflags\fP には以下に示すものも指定できる。 これらは GNU で拡張されたもので、POSIX.2 では定義されていない。
+.TP
+\fBGLOB_PERIOD\fP
+先頭のピリオドがメタキャラクタにマッチできるようにする。 デフォルトでは、メタキャラクタは先頭のピリオドにはマッチできない。
+.TP
+\fBGLOB_ALTDIRFUNC\fP
+ファイルシステムにアクセスする際に、通常のライブラリ関数の代わりに 代替関数 \fIpglob\->gl_closedir\fP,
+\fIpglob\->gl_readdir\fP, \fIpglob\->gl_opendir\fP, \fIpglob\->gl_lstat\fP,
+\fIpglob\->gl_stat\fP が用いられる。
+.TP
+\fBGLOB_BRACE\fP
+\fB{a,b}\fP という形式の \fBcsh\fP(1) スタイルの括弧表現を展開する。 括弧表現は入れ子にすることができる。
+したがって、例えば、"{foo/{,cat,dog},bar}" というパターンを 指定した場合に得られる結果は、 4つの文字列 "foo/",
+"foo/cat", "foo/dog", "bar" のそれぞれについて \fBglob\fP() を呼び出した場合と同じになる。
+.TP
+\fBGLOB_NOMAGIC\fP
+パターンにメタキャラクタが含まれていない場合、 マッチ結果として指定されたパターンだけを返す。
+パターンで指定された名前のファイルが存在しない場合であっても、 そのパターンが返される。
+.TP
+\fBGLOB_TILDE\fP
+チルダの展開を行う。 チルダ (\(aq~\(aq) がパターン内の唯一の文字の場合か、先頭のチルダの直後の文字が スラッシュ (\(aq/\(aq)
+の場合、チルダを呼び出し者のホームディレクトリで置換する。 先頭のチルダにユーザ名が続く場合 (例えば "~andrea/bin")、
+チルダとユーザ名をそのユーザのホームディレクトリで置換する。 ユーザ名が無効な場合やホームディレクトリが決定できない場合は、 置換は実行されない。
+.TP
+\fBGLOB_TILDE_CHECK\fP
+このフラグを指定すると \fBGLOB_TILDE\fP と同様の振舞いをする。 \fBGLOB_TILDE\fP との違いは、ユーザ名が無効だった場合や
+ホームディレクトリが決定できなかった場合に、 パターン自身を使用するのではなく、 \fBglob\fP() がエラーを示す \fBGLOB_NOMATCH\fP
を返すことである。
-.TP
-.B GLOB_ONLYDIR
-このフラグは、
-.BR glob ()
-に対する「ヒント」であり、
-呼び出し側がパターンにマッチするディレクトリにしか興味がないことを知らせる。
-実装においてファイルの種別情報を簡単に決定できる場合は、ディレクトリでない
-ファイルは呼び出し側に返されない。しかしながら、呼び出し側では、返された
-ファイルリストがディレクトリかどうかを確認しなければならない。
-(このフラグが存在するのは、呼び出し側がディレクトリにしか興味がない際に
+.TP
+\fBGLOB_ONLYDIR\fP
+このフラグは、 \fBglob\fP() に対する「ヒント」であり、 呼び出し側がパターンにマッチするディレクトリにしか興味がないことを知らせる。
+実装においてファイルの種別情報を簡単に決定できる場合は、ディレクトリでない ファイルは呼び出し側に返されない。しかしながら、呼び出し側では、返された
+ファイルリストがディレクトリかどうかを確認しなければならない。 (このフラグが存在するのは、呼び出し側がディレクトリにしか興味がない際に
性能を最適化する目的のためだけである。)
.PP
-.I errfunc
-が NULL でなければ、
-エラーが起こった場合には関数
-.I errfunc
-が呼び出される。関数の引数には、失敗したパス名
-.I epath
-と
-.I errno
-.RB ( opendir (3),
-.BR readdir (3),
-.BR stat (2).
-のいずれかによってセットされた値) が与えられる。
-.I errfunc
-が 0 以外の値を返すかもしくは
-.B GLOB_ERR
-がセットされた場合
-.BR glob ()
-は
-.I errfunc
-の呼び出し後に終了する。
+\fIerrfunc\fP が NULL でなければ、 エラーが起こった場合には関数 \fIerrfunc\fP が呼び出される。関数の引数には、失敗したパス名
+\fIepath\fP と \fIerrno\fP (\fBopendir\fP(3), \fBreaddir\fP(3), \fBstat\fP(2).
+のいずれかによってセットされた値) が与えられる。 \fIerrfunc\fP が 0 以外の値を返すかもしくは \fBGLOB_ERR\fP がセットされた場合
+\fBglob\fP() は \fIerrfunc\fP の呼び出し後に終了する。
.PP
-呼び出しが成功して戻った場合
-.I pglob\->gl_pathc
-にはマッチしたパス名が含まれ、
-.I pglob\->gl_pathv
-はマッチしたパス名へのポインタのリストへのポインタとなる。
-ポインタのリストは NULL ポインタで終端される。
+呼び出しが成功して戻った場合 \fIpglob\->gl_pathc\fP にはマッチしたパス名が含まれ、 \fIpglob\->gl_pathv\fP
+はマッチしたパス名へのポインタのリストへのポインタとなる。 ポインタのリストは NULL ポインタで終端される。
.PP
-.BR glob ()
-を何度か続けて呼び出すことができる。その際2回目以降の呼び出しでは
-.B GLOB_APPEND
-フラグが
-.I flags
+\fBglob\fP() を何度か続けて呼び出すことができる。その際2回目以降の呼び出しでは \fBGLOB_APPEND\fP フラグが \fIflags\fP
に設定されていなければならない。
.PP
-GNU の拡張として、
-.I pglob\->gl_flags
-には指定したフラグがセットされる。もし一つでもメタキャラクタが見付かれば
-このフラグと
-.B GLOB_MAGCHAR
-との \fBOR\fR を取った結果がセットされる。
+GNU の拡張として、 \fIpglob\->gl_flags\fP には指定したフラグがセットされる。もし一つでもメタキャラクタが見付かれば
+このフラグと \fBGLOB_MAGCHAR\fP との \fBOR\fP を取った結果がセットされる。
.SH 返り値
-呼び出しが成功して完了すると
-.BR glob ()
-は 0 を返す。
-それ以外の返り値は以下の通り:
-.TP
-.B GLOB_NOSPACE
+呼び出しが成功して完了すると \fBglob\fP() は 0 を返す。 それ以外の返り値は以下の通り:
+.TP
+\fBGLOB_NOSPACE\fP
メモリを使い果たした
-.TP
-.B GLOB_ABORTED
+.TP
+\fBGLOB_ABORTED\fP
読み取りエラー
-.TP
-.B GLOB_NOMATCH
+.TP
+\fBGLOB_NOMATCH\fP
一つもマッチしなかった
.SH 準拠
-POSIX.2, POSIX.1-2001.
+POSIX.2, POSIX.1\-2001.
.SH 注意
-glibc 2.1 では、
-.I gl_pathc
-と
-.I gl_offs
-は POSIX.2 で指定されているように
-.I size_t
-として宣言されている。
-libc4, libc5, glibc 2.0 では、
-.I int
-として宣言されている。
+glibc 2.1 では、 \fIgl_pathc\fP と \fIgl_offs\fP は POSIX.2 で指定されているように \fIsize_t\fP
+として宣言されている。 libc4, libc5, glibc 2.0 では、 \fIint\fP として宣言されている。
.SH バグ
-.BR glob ()
-関数はその中で呼び出している
-.BR malloc (3)
-や
-.BR opendir (3)
-などの関数の呼び出しで失敗が起こると失敗する。
-これにより
-.I errno
-にそのエラーコードが入る。
+\fBglob\fP() 関数はその中で呼び出している \fBmalloc\fP(3) や \fBopendir\fP(3)
+などの関数の呼び出しで失敗が起こると失敗する。 これにより \fIerrno\fP にそのエラーコードが入る。
.SH 例
使用法の一例を以下に示す。以下はシェルで
.sp
.in
.fi
.SH 関連項目
-.BR ls (1),
-.BR sh (1),
-.BR stat (2),
-.BR exec (3),
-.BR fnmatch (3),
-.BR malloc (3),
-.BR opendir (3),
-.BR readdir (3),
-.BR wordexp (3),
-.BR glob (7)
+\fBls\fP(1), \fBsh\fP(1), \fBstat\fP(2), \fBexec\fP(3), \fBfnmatch\fP(3), \fBmalloc\fP(3),
+\fBopendir\fP(3), \fBreaddir\fP(3), \fBwordexp\fP(3), \fBglob\fP(7)
OSDN Git Service
