FNMATCH
Section: C Library Functions (3)
索引
jman
BSD mandoc
索引
名称
fnmatch
- ファイル名かパス名を照合する
索引
書式
Fd #include <fnmatch.h>
Ft int
Fn fnmatch const char *pattern const char *string int flags
索引
解説
Fn fnmatch
関数は、シェルが使用する規則に従ってパターンを照合します。
Fa string
引数が指定する文字列をチェックし、
Fa pattern
引数が指定するパターンと一致するかどうか確認します。
Fa flags
引数は、
Fa pattern
と
Fa string
の解釈を修正します。
Fa flags
の値は、以下の定数のビット単位の論理和です。この定数は、
インクルードファイル
fnmatch.h
で定義されています。
- FNM_NOESCAPE
-
通常、
Fa pattern
の中でバックスラッシュ
(`\'
)
の後ろに 1 文字が続くものが現れるごとに、それはその文字で
置き換えられます。この置き換えは、その文字の特殊な意味を
無効にするために実行されます。
FNM_NOESCAPE
フラグを設定すると、バックスラッシュ文字は通常文字として扱われます。
- FNM_PATHNAME
-
Fa string
のスラッシュ文字は、
Fa pattern
中のスラッシュと
明確に一致する必要があります。このフラグを設定しないと、スラッシュは
通常文字として扱われます。
- FNM_PERIOD
-
Fa string
の最初のピリオドは、
Fa pattern
中の最初のピリオドと
明確に一致する必要があります。このフラグを設定しないと、最初のピリオドは
通常文字として扱われます。「最初の」という言葉の定義は、
FNM_PATHNAME
の指定によって変化します。
string
の第 1 キャラクタであるピリオドは、常に「最初の」ピリオドです。
FNM_PATHNAME
を設定した場合、スラッシュの直後のピリオドも「最初の」ピリオドです。
- FNM_LEADING_DIR
-
Fa pattern
が問題なく一致した後、残りの
/*
を無視します。
- FNM_CASEFOLD
-
Fa pattern
と
Fa string
の両方で大文字と小文字の区別を無視します。
索引
戻り値
Fn fnmatch
関数は、
Fa pattern
が指定するパターンに
Fa string
が一致するとゼロを戻します。一致しない場合は値
FNM_NOMATCH
を戻します。
索引
関連項目
sh(1),
glob(3),
regex(3)
索引
規格
Fn fnmatch
関数は、
St -p1003.2
に準拠しています。
索引
歴史
Fn fnmatch
関数は、
BSD 4.4
に追加されました。
索引
バグ
FNM_PATHNAME
を指定しても、パターン
`*'
は空ストリングと一致します。
索引
Index
- 名称
-
- 書式
-
- 解説
-
- 戻り値
-
- 関連項目
-
- 規格
-
- 歴史
-
- バグ
-
Time: 07:06:50 GMT, January 12, 2009