All search functions use $pattern parameter to specify match for filenames. Format of the $pattern depends on value of another parameter - $pattern_type.
If value of $pattern_type is 'php', then the pattern is case-sensitive string which follows the conventions of the ereg_*-functions.
In case of 'perl' pattern type it must follow the preg_*-functions pattern format. It is recommended to use 'perl', because it is faster.
The last 'shell' mode is most simple and should be familiar to everybody with basic computer skills. It is as easy as windows approach, but has some additional concepts borrowed from the FAR Manager software. The text of the following section was borrowed from the FAR Manager documentation.
File masks are used to select single files and folders or groups of them. Masks may contain common valid file name symbols, wildcards ('*' and '?') and special expressions:
|*||any number of characters;|
|?||any single character;|
|[c,x-z]||any character enclosed by the brackets. Both separate characters and character intervals are allowed.|
You may enter several file masks separated with commas or semicolons. For example, to select all the documents, you can specify *.doc,*.txt,*.wri in search pattern.
You may use exclude masks. An exclude mask is one or multiple file masks that must not be matched by the files matching the mask. The exclude mask is delimited from the main mask by the character '|'.
Usage examples of exclude masks:
All files with the extension cpp.
All files except for the files with extensions bak and tmp.
This mask has an error - the character | is entered, but the mask itself is not specified.
Also an error - the character | may not be contained in the mask more than once.
The same as *|*.bak
'shell' match mode is available from version 1.2.0 of File_Find