fnmatch
(PHP 4 >= 4.3.0, PHP 5)
fnmatch — ファイル名がパターンにマッチするか調べる
説明
bool fnmatch
( string $pattern
, string $string
[, int $flags
] )
fnmatch()はstring で指定された文字列が pattern で指定されたシェルワイルドカードにマッチするかどうかチェックします。
パラメータ
- pattern
-
シェルのワイルドカードパターン。
- string
-
調べたい文字列。この機能は特にファイル名のマッチに便利ですが、 通常の文字列に関しても使用できます。
一般的なユーザにとって、シェルパターンやあるいは少なくとも '?'と'*'によるワイルドカードのほうが 慣れていると思われます。そのため、 ereg() または preg_match() などの代わりに fnmatch() をフロントエンドの検索表現として使うことは、 プログラマではないユーザにとってより便利でしょう。
- flags
-
フラグ名については Unix のマニュアル fnmatch(3) も参照ください (そのうちここにも説明が追加されるでしょう)。
返り値
マッチした場合に TRUE、それ以外の場合に FALSE を返します。
例
Example#1 シェルのワイルドカードパターンによる色の名前のチェック
<?php
if (fnmatch("*gr[ae]y", $color)) {
echo "some form of gray ...";
}
?>
注意
警告
今のところ、この機能は Windows あるいは他の POSIX に準拠していないシステムで利用できません。