FNMATCH

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 15 octobre 2000
Index Menu principal

NOM

fnmatch - Correspondance de noms de fichiers

SYNOPSIS

#include <fnmatch.h>

int fnmatch(const char *pattern, const char *string, int flags);

DESCRIPTION

La fonction fnmatch() vérifie si l'argument string correspond avec le motif pattern, qui peut contenir des caractères génériques d'un interpréteur de commande.

L'argument flags modifie le comportement de la fonction. C'est un OU binaire entre zéro ou plusieurs des attributs suivants :

FNM_NOESCAPE: Traiter la contre oblique « \ » comme un caractère ordinaire, et non comme un caractère de déspécification.
FNM_PATHNAME: Ne faire correspondre une barre oblique « / » dans string qu'avec une barre oblique dans pattern, et pas avec un métacaractère comme un astérique « * » ou un point d'interrogation « ? » ni une expression entre crochets « [] » contenant une barre oblique.
FNM_PERIOD: Un point en début de string doit correspondre exactement avec un point dans pattern. Un point est considéré comme entête de chaîne, s'il est le premier caractère de string, ou si FNM_PATHNAME est défini, et si le point suit immédiatement une barre oblique.
FNM_FILE_NAME: Il s'agit d'un synonyme GNU de FNM_PATHNAME.
FNM_LEADING_DIR: (Extension GNU), la correspondance est considérée comme correcte si le motif correspond à un segment initial de la chaîne string suivi d'une barre oblique. Cet attribut est réservé pour un usage interne de la glibc, et n'est pas toujours implémenté.
FNM_CASEFOLD: (Extension GNU) Mise en correspondance insensible à la casse.

VALEUR RENVOYÉE

Zéro si la chaîne string correspond au motif pattern, FNM_NOMATCH s'il n'y a pas correspondance, et une autre valeur non nulle s'il y a erreur.

CONFORMITÉ

POSIX.2. Les attributs 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

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 23 octobre 1996 et révisée le 17 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 fnmatch ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 17 juillet 2008