fnmatch - comprueba la concordancia de un nombre de ruta o archivo
Biblioteca Estándar C (
libc,
-lc)
#include <fnmatch.h>
int fnmatch(const char *patron, const char *cadena, int flags);
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.
Cero si
cadena concuerda con
patron,
FNM_NOMATCH si no hay
concordancia, u otro valor distinto de cero si hay un error.
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 |
POSIX.1-2001, POSIX.1-2008, POSIX.2. Los modificadores
FNM_FILE_NAME,
FNM_LEADING_DIR, y
FNM_CASEFOLD son extensiones de GNU.
sh(1),
glob(3),
scandir(3),
wordexp(3),
glob(7)
La traducción al español de esta página del manual fue
creada por Gerardo Aburruzaga García <
[email protected]>,
Juan Piernas <
[email protected]>, Miguel Pérez Ibars
<
[email protected]> y Marcos Fouces <
[email protected]>
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
[email protected]