NOMBRE

       fnmatch - comprueba la concordancia de un nombre de ruta o archivo

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

SINOPSIS

       #include <fnmatch.h>

       int fnmatch(const char *patron, const char *cadena, int flags);

DESCRIPCIÓN

       La  función  fnmatch()  comprueba si el argumento cadena concuerda con el argumento patron
       que es un patrón al estilo de los comodines de la shell (vea glob(7)).

       El argumento flags modifica el comportamiento; es el resultado de aplicar el  operador  de
       bits OR (|) a cero o más de los siguientes modificadores:

       FNM_NOESCAPE
              Si  este  modificador  está  activado,  se  trata  al  carácter  de barra inclinada
              invertida ( como un carácter ordinario, en lugar de como un carácter de escape.

       FNM_PATHNAME
              Si este modificador está activado, un carácter de barra  inclinada  (/)  en  cadena
              sólo  concordará  con una barra inclinada en patron y no, por un asterisco (*) o un
              interrogante (?) ni por una secuencia entre corchetes ([]) que contenga  una  barra
              inclinada.

       FNM_PERIOD
              Si  este  modificador  está  activado,  un  punto inicial en cadena ha de concordar
              exactamente con un punto en patron. Se considera que un punto es inicial si  es  el
              primer  carácter  en  cadena,  o  si  FNM_PATHNAME  está  activado  y el punto está
              inmediatamente tras una barra inclinada.

       FNM_FILE_NAME
              Éste es un sinónimo de GNU para FNM_PATHNAME.

       FNM_LEADING_DIR
              Si este modificador (una extensión de GNU) está activado,  se  considerará  que  el
              patrón  concuerda si concuerda con un segmento inicial de cadena que va seguido por
              una barra inclinida. Esta opción es sobre todo para uso interno  de  glibc  y  sólo
              está implementada en ciertos casos.

       FNM_CASEFOLD
              Si  este  modificador  (una extensión de GNU) está activado, la concordancia con el
              patrón se realizará sin distinguir entre mayúsculas y minúsculas.

       FNM_EXTMATCH
              If this flag (a  GNU  extension)  is  set,  extended  patterns  are  supported,  as
              introduced  by  'ksh' and now supported by other shells.  The extended format is as
              follows, with pattern-list being a '|' separated list of patterns.

       '?(lista-de-patrones)'
              The pattern matches if zero or one occurrences  of  any  of  the  patterns  in  the
              pattern-list match the input string.

       '*(pattern-list)'
              The  pattern  matches  if  zero  or  more occurrences of any of the patterns in the
              pattern-list match the input string.

       '+(lista-de-patrones)'
              The pattern matches if one or more occurrences  of  any  of  the  patterns  in  the
              pattern-list match the input string.

       '@(lista-de-patrones)'
              The  pattern  matches  if  exactly  one  occurrence  of  any of the patterns in the
              pattern-list match the input string.

       '!(pattern-list)'
              The pattern matches if the input string cannot be matched with any of the  patterns
              in the pattern-list.

VALOR DEVUELTO

       Cero  si  cadena  concuerda  con  patron, FNM_NOMATCH si no hay concordancia, u otro valor
       distinto de cero si hay un error.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

       ┌───────────────────────────────────────────────┬────────────────────┬────────────────────┐
       │Interfaz                                       │ Atributo           │ Valor              │
       ├───────────────────────────────────────────────┼────────────────────┼────────────────────┤
       │fnmatch()                                      │ Seguridad del hilo │ MT-Safe env locale │
       └───────────────────────────────────────────────┴────────────────────┴────────────────────┘

ESTÁNDARES

       POSIX.1-2001, POSIX.1-2008, POSIX.2. Los modificadores FNM_FILE_NAME,  FNM_LEADING_DIR,  y
       FNM_CASEFOLD son extensiones de GNU.

VÉASE TAMBIÉN

       sh(1), glob(3), scandir(3), wordexp(3), glob(7)

TRADUCCIÓN

       La  traducción  al  español  de  esta  página del manual fue creada por Gerardo Aburruzaga
       García <gerardo.aburruzaga@uca.es>, Juan Piernas <piernas@ditec.um.es>, Miguel Pérez Ibars
       <mpi79470@alu.um.es> y Marcos Fouces <marcos@debian.org>

       Esta  traducción  es  documentación  libre;  lea  la  GNU General Public License Version 3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ o posterior con respecto a las condiciones  de
       copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si  encuentra  algún  error  en  la  traducción de esta página del manual, envíe un correo
       electrónico a ⟨debian-l10n-spanish@lists.debian.org⟩.