fnmatch(3)

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
FNM_IGNORECASE (same as FNM_CASEFOLD)
    If this flag is set, the pattern is matched case-insensitively.

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

fnmatch()
    POSIX.1-2008.

FNM_CASEFOLD
FNM_IGNORECASE
    POSIX.1-2024.

FNM_FILE_NAME
FNM_LEADING_DIR
    GNU.

HISTORIAL

fnmatch()
    POSIX.1-2001, POSIX.2.

FNM_CASEFOLD
    has been available on many systems even before POSIX.1-2024.

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.