From c9fca8aa6ce0eae0ef331f8e8942f7cbbb5ec971 Mon Sep 17 00:00:00 2001 From: David CARLIER Date: Wed, 28 Feb 2024 08:03:00 +0000 Subject: [PATCH] filesystem section sync with EN (#818) --- reference/filesystem/functions/fnmatch.xml | 172 ++++++++++++++------- 1 file changed, 120 insertions(+), 52 deletions(-) diff --git a/reference/filesystem/functions/fnmatch.xml b/reference/filesystem/functions/fnmatch.xml index 1a0e119491..71df9f49fd 100644 --- a/reference/filesystem/functions/fnmatch.xml +++ b/reference/filesystem/functions/fnmatch.xml @@ -1,6 +1,6 @@ - + @@ -30,57 +30,125 @@ pattern - Le masque Shell. - - - - - filename - - - La chaîne testée. Cette fonction est particulièrement utile pour les - noms de fichier, mais peut également être utilisée sur des chaînes - régulières. - - - L'utilisateur moyen de Shell peut être familier avec les masques Shell, - ou tout au moins, leurs expressions les plus simples, comme '?' et - '*'. De cette façon, utiliser - fnmatch au lieu de - preg_match pour des recherches peut être plus - pratique pour les non-initiés. - - - - - flags - - - La valeur de flags peut être une combinaison - des drapeaux suivants, joins avec l' - opérateur binaire OR (|). - - - Liste des drapeaux possibles pour <function>fnmatch</function> - - - - - Flag - Description - - - - - FNM_NOESCAPE - - Désactive l'échappement des antislashes. - - - - FNM_PATHNAME - - Un slash dans une chaîne correspond uniquement à un slash + Le pattern à comparer. Habituellement, le pattern contiendra + des caractères génériques tels que '?' et '*'. +
+ + Caractères génériques à utiliser dans le paramètre <parameter>pattern</parameter> + + + + + Caractère générique + &Description; + + + + + + ? + + + Le point d'interrogation correspondra à n'importe quel caractère unique. + Par exemple, le motif "file?.txt" correspondra à "file1.txt" et + "fileA.txt", mais ne correspondra pas à "file10.txt". + + + + + * + + + L'astérisque correspondra à zéro ou plusieurs caractères. + Par exemple, le motif "foo*.xml" correspondra à "foo.xml" et + "foobar.xml". + + + + + [ ] + + + Les crochets sont utilisés pour créer des plages de points de code ASCII ou des ensembles de caractères. + Par exemple, le motif "index.php[45]" correspondra à "index.php4" et + "index.php5", mais ne correspondra pas à "index.phpt". + Des plages bien connues sont [0-9], [a-z] et [A-Z]. + Plusieurs ensembles et plages peuvent être utilisés simultanément, par exemple [0-9a-zABC]. + + + + + ! + + + Le point d'exclamation est utilisé pour nier les caractères dans les crochets. + Par exemple, "[!A-Z]*.html" correspondra à "demo.html", mais ne correspondra pas à + "Demo.html". + + + + + \ + + + Le backslash est utilisé pour échapper les caractères spéciaux. + Par exemple, "Name\?" correspondra à "Name?", mais ne correspondra pas à + "Names". + + + + +
+ + + + + filename + + + La chaîne testée. Cette fonction est particulièrement utile pour les + noms de fichier, mais peut également être utilisée sur des chaînes + régulières. + + + L'utilisateur moyen de Shell peut être familier avec les masques Shell, + ou tout au moins, leurs expressions les plus simples, comme '?' et + '*'. De cette façon, utiliser + fnmatch au lieu de + preg_match pour des recherches peut être plus + pratique pour les non-initiés. + + + + + flags + + + La valeur de flags peut être une combinaison + des drapeaux suivants, joins avec l' + opérateur binaire OR (|). + + + Liste des drapeaux possibles pour <function>fnmatch</function> + + + + + Flag + &Description; + + + + + FNM_NOESCAPE + + Désactive l'échappement des antislashes. + + + + FNM_PATHNAME + + Un slash dans une chaîne correspond uniquement à un slash dans le masque fourni.