無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

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 を返します。

例1 シェルのワイルドカードパターンによる色の名前のチェック

<?php
if (fnmatch("*gr[ae]y"$color)) {
  echo 
"some form of gray ...";
}
?>

注意

警告

今のところ、この機能は Windows あるいは他の POSIX に準拠していないシステムで利用できません。