Scroll to navigation

fnmatch(3) Library Functions Manual 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:

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.
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.
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.
Éste es un sinónimo de GNU para FNM_PATHNAME.
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.
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.
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 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.

15 Diciembre 2022 Páginas de manual de Linux 6.03