NOMBRE¶
grep, egrep, fgrep - muestran líneas que concuerdan con un patrón
SINOPSIS¶
grep [-AB] núm] [-CEFGVbchiLlnqsvwxyUu] [[-e ] patrón | -f
fichero] [--extended-regexp] [--fixed-strings] [--basic-regexp]
[--regexp=PATRÓN] [--file=FICHERO] [--ignore-case] [--word-regexp]
[--line-regexp] [--line-regexp] [--no-messages] [--invert-match] [--version]
[--help] [--byte-offset] [--line-number] [--with-filename] [--no-filename]
[--quiet] [--silent] [--files-without-match] [--files-with-matcces] [--count]
[--before-context=NUM] [--after-context=NUM] [--context] [--binary]
[--unix-byte-offsets]
ficheros...
DESCRIPCIÓN¶
Grep busca en la entrada, bien en la que se le especifica con nombres de
ficheros o bien en la entrada estándar si no se le dan dichos
nombres o si uno de éstos consiste en
-, líneas que
concuerden o coincidan con el
patrón dado. Si no se dice otra
cosa,
grep muestra las líneas que concuerden.
Hay tres grandes variantes de
grep, controladas por las siguientes
opciones:
- -G, --basic-regexp
- Interpreta patrón como una expresión regular
básica (vea más abajo). Éste es el comportamiento
predeterminado.
- -E, --extended-regexp
- Interpreta patrón coma una expresión regular
extendida (vea más adelante).
- -F, --fixed-strings
- Interpreta patrón como una lista de cadenas de caracteres
fijas, separadas por saltos de línea; se busca la concordancia de
una cualquiera de ellas.
Además, están disponibles dos programas que son variantes de
éste:
egrep y
fgrep.
egrep es similar (pero no
idéntico) a
grep -E, y es compatible con el
egrep
histórico de Unix.
fgrep es lo mismo que
grep -F.
Todas las variantes de
grep entienden las siguientes opciones:
- -núm
- Las líneas concordantes se mostrarán acompañadas de
núm líneas anteriores y posteriores. Sin embargo,
grep nunca mostrará cualquier línea dada más
de una vez.
- -A núm , --after-context=NÚM
- Muestra núm líneas de contexto después de las
que concuerden con el patrón.
- -B núm , --before-context=NÚM
- Muestra núm líneas de contexto antes de las que
concuerden con el patrón.
- -C, --context
- Equivalente a -2.
- -V, --version
- Muestra el número de versión de grep en la salida
estándar de errores. Este número de versión
debería incluirse en todos los informes de fallos (vea más
abajo).
- -b, --byte-offset
- Muestra el desplazamiento en bytes desde el principio del fichero de
entrada antes de cada línea de salida.
- -c, --count
- Suprime la salida normal; en su lugar muestra el número de
líneas que concuerdan con el patrón para cada fichero de
entrada. Con la opción -v, --invert-match (vea más
abajo), muestra el número de líneas que no concuerden.
- -e patrón,--regexp=PATRÓN
- Emplea patrón como el patrón; útil para
proteger patrones que comiencen con -.
- -f fichero,--file=FICHERO
- Obtiene el patrón de fichero.
- -h, --no-filename
- Suprime la impresión de los nombres de ficheros antes de las
líneas concordantes en la salida, cuando se busca en varios
ficheros.
- -i, --ignore-case
- No hace caso de si las letras son mayúsculas o minúsculas ni
en el patrón ni en los ficheros de entrada.
- -L, --files-without-match
- Suprime la salida normal; en su lugar muestra el nombre de cada fichero de
entrada donde no se encuentre ninguna concordancia y por lo tanto de cada
fichero que no produciría ninguna salida. La búsqueda se
detendrá al llegar a la primera concordancia.
- -l, --files-with-matches
- Suprime la salida normal; en su lugar muestra el nombre de cada fichero de
entrada que produciría alguna salida. La búsqueda se
detendrá en la primera concordancia.
- -n, --line-number
- Prefija cada línea de salida con el número de línea
de su fichero de entrada correspondiente.
- -q, --quiet
- Silencioso; suprime la salida normal. La búsqueda finaliza en la
primera concordancia.
- -s, --silent
- Suprime los mensajes de error sobre ficheros que no existen o no se pueden
leer.
- -v, --invert-match
- Invierte el sentido de la concordancia, para seleccionar las líneas
donde no las hay.
- -w, --word-regexp
- Selecciona solamente aquellas líneas que contienen concordancias
que forman palabras completas. La comprobación consiste en que la
cadena de caracteres concordante debe estar al principio de la
línea o precedida por un carácter que no forme parte de una
palabra. De forma similar, debe estar o al final de la línea o ser
seguida por un carácter no constituyente de palabra. Los caracteres
que se consideran como parte de palabras son letras, dígitos y el
subrayado.
- -x, --line-regexp
- Selecciona solamente aquellas concordancias que constan de toda la
línea.
- -y
- Sinónimo obsoleto de -i.
- -U, --binary
- Trata el(los) fichero(s) como binario(s). De forma predeterminada, bajo
MS-DOS y MS-Windows, grep intenta adivinar el tipo del fichero
mirando los contenidos de los primeros 32 kB leídos de él.
Si grep decide que el fichero es de texto, quita los caracteres CR
(retorno de carro) de los contenidos originales del fichero (para que las
expresiones regulares con ^ y $ funcionen correctamente). Al
especificar -U deshabilitamos este intento de adivinación
del tipo del fichero, haciendo que todos se lean y pasen al mecanismo de
concordancia tal cuales; si el fichero lo es de texto y tiene al final de
cada línea el par de caracteres CR/LF, esto hará que algunas
expresiones regulares fallen. Esta opción sólo tiene sentido
en MS-DOS y MS-Windows.
- -u, --unix-byte-offsets
- Informa de desplazamientos de bytes al estilo de Unix. Esta opción
hace que grep muestre los desplazamientos de bytes como si el
fichero fuera de texto al estilo de Unix; o sea, sin los caracteres CR al
final de cada línea. Esto producirá resultados
idénticos a ejecutar grep en un sistema Unix. Esta
opción no tiene efecto a menos que se dé también la
opción -b; sólo tiene sentido en MS-DOS y
MS-Windows.
EXPRESIONES REGULARES¶
Una expresión regular es un patrón que describe un conjunto de
cadenas de caracteres. Las expresiones regulares se construyen de forma
análoga a las expresiones aritméticas, combinando expresiones
más pequeñas mediante ciertos operadores para formar expresiones
complejas.
El programa
grep entiende dos versiones diferentes de sintaxis para las
expresiones regulares: la ``básica'' y la ``extendida''. En la
versión de
grep de GNU, no hay diferencia en usar una u otra en
cuanto a la funcionalidad disponible. En otras implementaciones, las
expresiones regulares básicas son menos potentes. La siguiente
descripción se aplica a expresiones regulares extendidas; las
diferencias con las básicas se resumen a continuación.
Los bloques de construcción fundamentales son las expresiones regulares
que concuerdan con un solo carácter. La mayoría de los
caracteres, incluyendo todas las letras y dígitos, son expresiones
regulares que concuerdan consigo mismos. Cualquier meta-carácter con un
significado especial debe ser protegido precediéndolo con una barra
inclinada inversa.
Una lista de caracteres rodeados por
[ y
] concuerda con cualquier
carácter de esa lista; si el primer carácter de la lista es el
acento circunflejo
^ entonces concuerda con cualquier carácter
de
fuera de la lista. Por ejemplo, la expresión regular
[0123456789] concuerda con cualquier carácter dígito. Se
puede especificar un rango de caracteres ASCII dando el primero y el
último, separados por un guión. Finalmente, están
predefinidas ciertas clases de caracteres, con un nombre para cada una. Estos
nombres son auto-explicativos, y son
[:alnum:],
[:alpha:],
[:cntrl:],
[:digit:],
[:graph:],
[:lower:],
[:print:],
[:punct:],
[:space:],
[:upper:], y
[:xdigit:]. Por ejemplo,
[[:alnum:]] significa (en
inglés)
[0-9A-Za-z], salvo que la última forma depende de
que la codificación de caracteres siga el estándar ISO-646 o
ASCII, mientras que la primera es transportable. (Observe que los corchetes en
estos nombres de clases son parte de los nombres simbólicos, y deben
incluirse además de los corchetes que delimitan la lista entre
corchetes.) La mayor parte de los meta-caracteres pierden su significado
especial dentro de estas listas. Para incluir un
] literal,
póngalo el primero de la lista. De forma similar, para incluir un
^ literal, póngalo en cualquier sitio menos el primero.
Finalmente, para incluir un
- literal, póngalo el último.
El punto
. concuerda con cualquier carácter solo. El
símbolo
\w es un sinónimo de
[[:alnum:]] y
\W lo es de
[^[:alnum]].
El acento circunflejo
^ y el signo del dólar (y del escudo
portugués)
$ son meta-caracteres que respectivamente concuerdan
con la cadena vacía al comienzo y al final de una línea. Los
símbolos
\< y
\> respectivamente concuerdan con la
cadena vacía al principio y al final de una palabra. El símbolo
\b concuerda con la cadena vacía al borde de una palabra, y
\B concuerda con la cadena vacía supuesto que
no
esté en el extremo de una palabra.
Una expresión regular que concuerde con un solo carácter puede ser
seguida por uno de estos varios operadores de repetición:
- ?
- El elemento precedente es opcional y concuerda como mucho una vez.
- *
- El elemento precedente concordará cero o más veces.
- +
- El elemento precedente concordará una o más veces.
- {n}
- El elemento precedente concuerda exactamente n veces.
- {n,}
- El elemento precedente concuerda n o más veces.
- {,m}
- El elemento precedente es opcional y concuerda como mucho m
veces.
- {n,m}
- El elemento precedente concuerda como poco n veces, pero no
más de m veces.
Dos expresiones regulares pueden concatenarse; la expresión regular
resultante concuerda con cualquier cadena formada mediante la
concatenación de dos subcadenas que concuerdan respectivamente con las
subexpresiones concatenadas.
Dos expresiones regulares pueden juntarse mediante el operador infijo
|;
la expresión regular resultante concuerda con cualquier cadena que
concuerde con cualquiera de las subexpresiones.
La repetición tiene precedencia sobre la concatenación, la cual a
su vez tiene precedencia sobre la alternancia. Una subexpresión entera
puede ser encerrada entre paréntesis para subvertir estas reglas de
precedencia.
La retrorreferencia
\n, donde
n es un dígito simple,
concuerda con la subcadena que previamente concordó con la
n-sima subexpresión entre paréntesis de la
expresión regular.
En las expresiones regulares básicas, los meta-caracteres
?,
+,
{,
|,
(, y
) pierden su significado
especial; en su lugar emplee las versiones protegidas mediante la barra
inversa
\?,
\+,
\{,
\|,
\(, y
\).
En
egrep, el meta-carácter
{ pierde su significado
especial; en su lugar emplee
\{.
DIAGNÓSTICOS¶
Normalmente, el status de salida es 0 si se encuentran concordancias, y 1 si no
se encuentran. (La opción
-v invierte el sentido del status de
salida.) El status de salida es 2 si había errores de sintaxis en el
patrón, si los ficheros de entrada eran inaccesibles, o en caso de
otros errores del sistema.
FALLOS¶
Envíe informes sobre fallos por correo electrónico a la
dirección
bug-gnu-utils@prep.ai.mit.edu. Asegúrese de
incluir la palabra ``grep'' en algún sitio del campo ``Asunto:''
(``Subject:'').
Números de repetición grandes en la construcción
{m,n} pueden hacer que grep emplee grandes
cantidades de memoria. En adición a esto, ciertas otras obscuras
expresiones regulares requieren tiempo y espacio exponenciales, y pueden hacer
que
grep se quede sin memoria.
Las retrorreferencias son muy lentas, y pueden requerir un tiempo
exponencial.
