Skip to content

Commit

Permalink
filesystem section sync with EN (#818)
Browse files Browse the repository at this point in the history
  • Loading branch information
@devnexen
devnexen authored Feb 28, 2024
1 parent 8283bd5 commit c9fca8a
Showing 1 changed file with 120 additions and 52 deletions.
172 changes: 120 additions & 52 deletions reference/filesystem/functions/fnmatch.xml
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: yannick Status: ready -->
<!-- EN-Revision: 946fbe44b60bd5fdc1d7b7a5f016be670425f5b4 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.fnmatch" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -30,57 +30,125 @@
<term><parameter>pattern</parameter></term>
<listitem>
<para>
Le masque Shell.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
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.
</para>
<para>
L'utilisateur moyen de Shell peut être familier avec les masques Shell,
ou tout au moins, leurs expressions les plus simples, comme <literal>'?'</literal> et
<literal>'*'</literal>. De cette façon, utiliser
<function>fnmatch</function> au lieu de
<function>preg_match</function> pour des recherches peut être plus
pratique pour les non-initiés.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
La valeur de <parameter>flags</parameter> peut être une combinaison
des drapeaux suivants, joins avec l'
<link linkend="language.operators.bitwise">opérateur binaire OR (|)</link>.
<table>
<title>
Liste des drapeaux possibles pour <function>fnmatch</function>
</title>
<tgroup cols="2">
<thead>
<row>
<entry><parameter>Flag</parameter></entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><constant>FNM_NOESCAPE</constant></entry>
<entry>
Désactive l'échappement des antislashes.
</entry>
</row>
<row>
<entry><constant>FNM_PATHNAME</constant></entry>
<entry>
Un slash dans une chaîne correspond uniquement à un slash
Le <parameter>pattern</parameter> à comparer. Habituellement, le <parameter>pattern</parameter> contiendra
des caractères génériques tels que <literal>'?'</literal> et <literal>'*'</literal>.
<table>
<title>
Caractères génériques à utiliser dans le paramètre <parameter>pattern</parameter>
</title>
<tgroup cols="2">
<thead>
<row>
<entry>Caractère générique</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>
<literal>?</literal>
</entry>
<entry>
Le point d'interrogation correspondra à n'importe quel caractère unique.
Par exemple, le motif <literal>"file?.txt"</literal> correspondra à <literal>"file1.txt"</literal> et
<literal>"fileA.txt"</literal>, mais ne correspondra pas à <literal>"file10.txt"</literal>.
</entry>
</row>
<row>
<entry>
<literal>*</literal>
</entry>
<entry>
L'astérisque correspondra à zéro ou plusieurs caractères.
Par exemple, le motif <literal>"foo*.xml"</literal> correspondra à <literal>"foo.xml"</literal> et
<literal>"foobar.xml"</literal>.
</entry>
</row>
<row>
<entry>
<literal>[ ]</literal>
</entry>
<entry>
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 <literal>"index.php[45]"</literal> correspondra à <literal>"index.php4"</literal> et
<literal>"index.php5"</literal>, mais ne correspondra pas à <literal>"index.phpt"</literal>.
Des plages bien connues sont <literal>[0-9]</literal>, <literal>[a-z]</literal> et <literal>[A-Z]</literal>.
Plusieurs ensembles et plages peuvent être utilisés simultanément, par exemple <literal>[0-9a-zABC]</literal>.
</entry>
</row>
<row>
<entry>
<literal>!</literal>
</entry>
<entry>
Le point d'exclamation est utilisé pour nier les caractères dans les crochets.
Par exemple, <literal>"[!A-Z]*.html"</literal> correspondra à <literal>"demo.html"</literal>, mais ne correspondra pas à
<literal>"Demo.html"</literal>.
</entry>
</row>
<row>
<entry>
<literal>\</literal>
</entry>
<entry>
Le backslash est utilisé pour échapper les caractères spéciaux.
Par exemple, <literal>"Name\?"</literal> correspondra à <literal>"Name?"</literal>, mais ne correspondra pas à
<literal>"Names"</literal>.
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
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.
</para>
<para>
L'utilisateur moyen de Shell peut être familier avec les masques Shell,
ou tout au moins, leurs expressions les plus simples, comme <literal>'?'</literal> et
<literal>'*'</literal>. De cette façon, utiliser
<function>fnmatch</function> au lieu de
<function>preg_match</function> pour des recherches peut être plus
pratique pour les non-initiés.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
La valeur de <parameter>flags</parameter> peut être une combinaison
des drapeaux suivants, joins avec l'
<link linkend="language.operators.bitwise">opérateur binaire OR (|)</link>.
<table>
<title>
Liste des drapeaux possibles pour <function>fnmatch</function>
</title>
<tgroup cols="2">
<thead>
<row>
<entry><parameter>Flag</parameter></entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry><constant>FNM_NOESCAPE</constant></entry>
<entry>
Désactive l'échappement des antislashes.
</entry>
</row>
<row>
<entry><constant>FNM_PATHNAME</constant></entry>
<entry>
Un slash dans une chaîne correspond uniquement à un slash
dans le masque fourni.
</entry>
</row>
Expand Down

0 comments on commit c9fca8a

Please sign in to comment.