Forum und email

fnmatch

(PHP 4 >= 4.3.0, PHP 5)

fnmatch — Compara nome de arquivo com um padrão

Descrição

bool fnmatch ( string $pattern , string $string [, int $flags ] )

fnmatch() verifica se a string passada combina com o padrão de curingas shell pattern .

Parâmetros

pattern

Padrão de curingas shell

string

A string testada. Esta função é especialmente útil para nomes de arquivo, mas também pode ser usada em strings normais.

O usuário comum pode estar acostumado com padrões shell ou pelo menos, na sua forma mais simples, aos curingas '?' e '*'. Então usar fnmatch() ao invés de ereg() ou preg_match() para pesquisas pela interface pode ser muito mais conveniente para usuários não programadores.

flags

Veja a manpage Unix de fnmatch(3) para nomes de flags (contanto que não estejam documentadas aqui).

Valor Retornado

Retorna TRUE se combinar, FALSE do contrário.

Exemplos

Example#1 Comparando uma cor com um padrão de curingas shell

<?php
if (fnmatch("*gr[ae]y"$color)) {
  echo 
"alguma forma da cor gray (cinza) ...";
}
?>

Notas

Aviso

Por enquanto esta função não está disponível no Windows ou outros sistemas não POSIX.