Provided by: manpages-fr-dev_4.21.0-2_all 
NOM
fnmatch - Rechercher une correspondance entre un nom de fichier ou un chemin et un motif
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
SYNOPSIS
#include <fnmatch.h>
int fnmatch(const char *motif, const char *chaîne, int drapeaux);
DESCRIPTION
La fonction fnmatch() vérifie si l'argument chaîne correspond au motif qui est un motif avec des
méta-caractères de l'interpréteur de commandes (voir glob(7)).
L'argument drapeaux modifie le comportement de la fonction. C'est un OU binaire entre zéro ou plusieurs
des drapeaux suivants :
FNM_NOESCAPE
Si ce drapeau est défini, traiter la barre oblique inverse « \ » comme un caractère ordinaire et
non comme un caractère d'échappement.
FNM_PATHNAME
Si ce drapeau est défini, ne faire correspondre une barre oblique « / » dans chaîne qu'avec une
barre oblique dans motif, et pas avec les méta-caractères « * » ou « ? », ni avec une expression
entre crochets « [] » contenant une barre oblique.
FNM_PERIOD
Si ce drapeau est défini, un point en début de chaîne doit correspondre exactement à un point dans
motif. Un point est considéré comme en début de chaîne, s'il est le premier caractère de chaîne,
ou si FNM_PATHNAME est défini alors que le point suit immédiatement une barre oblique.
FNM_FILE_NAME
Il s'agit d'un synonyme GNU de FNM_PATHNAME.
FNM_LEADING_DIR
Si ce drapeau (une extension GNU) est défini, la correspondance est considérée comme correcte si
le motif correspond à un segment initial de la chaîne chaîne suivi d'une barre oblique. Ce drapeau
est réservé à un usage interne de la glibc et n'est pas toujours implémenté.
FNM_CASEFOLD
Si ce drapeau (une extension GNU) est défini, la correspondance est recherchée sans tenir compte
de la casse.
FNM_EXTMATCH
Si ce drapeau (extension GNU) est défini, les motifs étendus sont pris en charge tels
qu'introduits par « ksh », et désormais pris en charge par d'autres interpréteurs de commandes. Le
format étendu se présente comme suit, liste_motifs étant une liste de motifs séparés par des
« | ».
« ?(liste_motifs) »
Le motif correspond si au plus une occurrence des motifs listés dans liste_motifs correspond à la
chaîne spécifiée.
« *(liste_motifs) »
Le motif correspond si zéro ou plusieurs occurrences des motifs listés dans liste_motifs
correspondent à la chaîne spécifiée.
« +(liste_motifs) »
Le motif correspond si au moins une occurrence des motifs listés dans liste_motifs correspond à la
chaîne spécifiée.
« @(liste_motifs) »
Le motif correspond si une et une seule occurrence des motifs listés dans liste_motifs correspond
à la chaîne spécifiée.
« !(liste_motifs) »
Le motif correspond si la chaîne spécifiée ne peut correspondre à aucun des motifs listés dans
liste_motifs.
VALEUR RENVOYÉE
Zéro si chaîne correspond au motif, FNM_NOMATCH s'il n'y a pas correspondance et une autre valeur non
nulle s'il y a une erreur.
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter attributes(7).
┌───────────────────────────────────────────────────────────┬──────────────────────┬────────────────────┐
│ Interface │ Attribut │ Valeur │
├───────────────────────────────────────────────────────────┼──────────────────────┼────────────────────┤
│ fnmatch() │ Sécurité des threads │ MT-Safe env locale │
└───────────────────────────────────────────────────────────┴──────────────────────┴────────────────────┘
STANDARDS
POSIX.1-2001, POSIX.1-2008, POSIX.2. Les drapeaux FNM_FILE_NAME, FNM_LEADING_DIR et FNM_CASEFOLD sont des
extensions GNU.
VOIR AUSSI
sh(1), glob(3), scandir(3), wordexp(3), glob(7)
TRADUCTION
La traduction française de cette page de manuel a été créée par Christophe Blaess
<https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvi‐
gnaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fe‐
vrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@de‐
bian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra‐
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org>, Frédéric Hantrais <fhan‐
trais@gmail.com> et Lucien Gentis <lucien.gentis@waika9.com>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License
version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à de‐
bian-l10n-french@lists.debian.org.
Pages du manuel de Linux 6.03 15 décembre 2022 fnmatch(3)