agrep - manual de referência, opções, exemplos de comandos


NOME

agrep - linhas de impressão que correspondem aproximadamente a um padrão

SINOPSE

agrep [OPTION]... PATTERN [FILE]...

DESCRIÇÃO

Procura correspondências aproximadas de PATTERN em cada ARQUIVO ou entrada padrão. Exemplo:

agrep -2 optimize foo.txt

gera todas as linhas no arquivo `foo.txt' que correspondem a "otimizar" dentro de dois erros. Por exemplo. as linhas que contêm "optimize", "optmise" e "opitmize" correspondem todas.

OPÇÕES

Seleção e interpretação de regexp:

-e PATTERN, - -regexp=PATTERN

Use PATTERN como uma expressão regular; útil para proteger padrões começando com -.

-i, - -ignore-case

Ignore as distinções de maiúsculas e minúsculas (conforme definido pela localidade atual) em PATTERN e arquivos de entrada.

-k, - -literal

Trate PATTERN como uma string literal, ou seja, uma string fixa sem caracteres especiais.

-w, - -word-regexp

Força PATTERN a corresponder apenas a palavras inteiras. Uma "palavra inteira" é uma substring que começa no início ou no registro ou é precedida por um caractere constituinte não-palavra. Da mesma forma, a substring deve terminar no final do registro ou ser seguida por um caractere que não seja uma palavra. Os caracteres constituintes da palavra são alfanuméricos (conforme definido pela localidade atual) e o caractere de sublinhado. Observe que os caracteres não constituintes de palavras devem cercar a correspondência; eles não podem ser contados como erros.

Configurações de correspondência aproximadas:

-D NUM, - -delete-cost=NUM

Defina o custo dos caracteres ausentes como NUM.

-I NUM, - -insert-cost=NUM

Defina o custo de caracteres extras para NUM.

-S NUM, - -substitute-cost=NUM

Defina o custo de caracteres incorretos para NUM. Observe que uma exclusão (um caractere ausente) e uma inserção (um caractere extra) juntas constituem um caractere substituído, mas o custo será o de uma exclusão e uma inserção somadas. Assim, se o const de uma substituição for maior que a soma dos custos de exclusão e inserção, as substituições diretas nunca serão feitas.

-E NUM, - -max-errors=NUM

Selecione registros que tenham no máximo NUM erros.

-#

Selecione registros que tenham no máximo # erros (# é um dígito entre 0 e 9).

Diversos:

-d PATTERN, - -delimiter=PATTERN

Defina a expressão regular do delimitador de registro como PATTERN. O texto entre dois delimitadores, antes do primeiro delimitador e depois do último delimitador é considerado um registro. O delimitador de registro padrão é o regexp "\n", portanto, por padrão, um registro é uma linha. PATTERN pode ser qualquer expressão regular que não corresponda à string vazia. Por exemplo, usar -d "^From" define mensagens de e-mail como registros em um arquivo de formato de caixa de correio.

-v, - -invert-match

Selecione registros não correspondentes em vez de registros correspondentes.

-V, - -version

Imprima as informações da versão e saia.

-y, - -nothing

Faz nada. Esta opção existe apenas para compatibilidade com o programa non-free agrep.

- -help

Exiba uma breve mensagem de ajuda e saia.

Controle de saída:

-B, - -best-match

Gere apenas os melhores registros correspondentes, ou seja, os registros com o menor custo. Atualmente, isso é implementado fazendo duas passagens nos arquivos de entrada e não pode ser usado ao ler da entrada padrão.

- -color, - -colour

Destaque as strings correspondentes na saída com um marcador de cor. A sequência de cores é obtida da variável de ambiente GREP_COLOR. A cor padrão é vermelha.

-c, - -count

Imprima apenas uma contagem de registros correspondentes para cada arquivo de entrada, suprimindo a saída normal.

-h, - -no-filename

Suprima o prefixo do nome do arquivo na saída quando vários arquivos forem pesquisados.

-H, - -with-filename

Prefixe cada registro de saída com o nome do arquivo de entrada de onde o registro foi lido.

-l, - -files-with-matches

Imprima apenas o nome de cada arquivo de entrada que contém pelo menos uma correspondência, suprimindo a saída normal. A verificação de cada arquivo será interrompida na primeira correspondência.

-n, - -record-number

Prefixe cada registro de saída com seu número de sequência no arquivo de entrada. O número do primeiro registro é 1.

-q, - -quiet, - -silent

Não grave nada na saída padrão. Saia imediatamente com status de saída zero se uma correspondência for encontrada.

-s, - -show-cost

Custo de correspondência de impressão com saída.

- -show-position

Prefixe cada registro de saída com o deslocamento inicial e final da primeira correspondência no registro. O deslocamento do primeiro caractere do registro é 0. A posição final é dada como o deslocamento do primeiro caractere após a correspondência.

-M, - -delimiter-after

Por padrão, o delimitador de registro é o caractere de nova linha e é gerado após o registro correspondente. Se -d for usado, o delimitador do registro será gerado antes do registro correspondente. Esta opção faz com que o delimitador seja gerado após o registro correspondente.

Sem FILE, ou quando FILE for -, lê a entrada padrão. Se forem fornecidos menos de dois FILEs, -h é assumido, caso contrário, -H é o padrão.

DIAGNÓSTICO

O status de saída é 0 se uma correspondência for encontrada, 1 para nenhuma correspondência e 2 se houver erros. Se -E ou -# não for especificado, apenas correspondências exatas serão selecionadas.

PATTERN é uma expressão regular estendida POSIX (ERE) com as extensões TRE.

RELATANDO BUGS

Relate bugs para a lista de discussão do TRE <tre-general@lists.laurikari.net>.

DIREITO AUTORAL

Copyright © 2002-2004 Ville Laurikari.
Este é um software gratuito e vem com ABSOLUTAMENTE NENHUMA GARANTIA. Você pode redistribuir este software sob certas condições; veja a fonte para o texto completo da licença.