Toutes les fonctions de recherche utilisent le paramètre $pattern pour spécifier le masque des noms de fichiers Le format de $pattern dépend de la valeur d'un autre paramètre : $pattern_type .

• Si la valeur de $pattern_type est 'php' , alors le masque sera une chaîne sensible à la casse qui suit les conventions des fonctions PHP ereg_*.

• Si la valeur est 'perl' , le masque suivra le format des masques des fonctions PHP preg_*. Il est recommandé d'utiliser ce mode car il est plus rapide à l'exécution.

• Le dernier mode, 'shell' , est plus simple et devrait être familier à tout le monde. Il est aussi simple que l'approche Windows avec quelques concepts en plus issus du logiciel FAR Manager. Le texte de ce chapitre est un copier/coller de sa documentation.

Les masques de fichiers sont utilisés pour sélectionner des fichiers, des dossiers ou des groupes de fichiers/dossiers. Les masques peuvent contenir tous les symboles valides dans un nom de fichier, des jockers ('*' and '?') ainsi que des expressions spéciales :

• *
• n'importe quel nombre de caractères;
• ?
• n'importe quel caractère (un seul);
• [c,x-z]
• n'importe quel caractère contenu entre les crochets. Une liste de caractère ainsi qu'un intervelle de caractères sont autorisés.

Par exemple, les fichiers ftp.exe, fc.exe et f.ext peuvent être sélectionnés en utilisant le masque f*.ex?, le masque *co* sélectionnera le fichier color.ini et edit.com, le masque [c-f,t]*.txt peut sélectionner config.txt, demo.txt, faq.txt et tips.txt.

Vous pouvez fournir plusieurs masques séparés par une virgule ou un point-virgule. ar exemple, pour sélectionner tous les documents, vous pouvez spécifier *.doc,*.txt,*.wri dans le masque de recherche.

Vous pouvez utiliser exclude masks. Un masque d'exclusion est un ou plusieurs masques qui ne doivent pas correspondre à des fichiers. Un masque d'exclusion est délimité du masque principal par le caractère '|'.

Exemple d'utilisation des masques d'exclusion :

1. *.cpp

   Tous les fichiers avec l'extension cpp.

2. *.*|*.bak,*.tmp

   Tous les fichiers exceptés ceux dont les extensions sont bak et tmp.

3. *.*|

   Ce masque contient une erreur - le caractère | est fourni mais le masque lui-même n'est pas spécifié.

4. *.*|*.bak|*.tmp

   également une erreur - le caractère | ne peut être présent qu'une seule fois dans le masque.

5. |*.bak

   La même chose que le masque *|*.bak

La virgule (ou le point-birgule) est utilisée pour séparer les masques les uns des autres et le caractères '|' sépare les masques des masques d'exclusion.

Le mode 'shell' est disponible depuis la version 1.2.0 de File_Find