zpcregrep - Online na nuvem

PROGRAMA:

NOME

pcregrep - um grep com expressões regulares compatíveis com Perl.

SINOPSE

pcregrep [opções] [grande opções] [padronizar] [caminho1 caminho2 ...] zpcregrep [opções] [grande
opções] [padronizar] [arquivo1 file2 ...]

DESCRIÇÃO

pcregrep procura arquivos por padrões de caracteres, da mesma forma que outros comandos grep fazem,
mas usa a biblioteca de expressão regular PCRE para suportar padrões que são compatíveis
com as expressões regulares do Perl 5. Veja sintaxe(3) para um resumo de referência rápida de
sintaxe de padrão, ou padrão pcre(3) para uma descrição completa da sintaxe e semântica de
as expressões regulares que o PCRE suporta.

Os padrões, sejam fornecidos na linha de comando ou em um arquivo separado, são fornecidos sem
delimitadores. Por exemplo:

pcregrep quinta-feira / etc / motd

Se você tentar usar delimitadores (por exemplo, circundando um padrão com barras, como
é comum em scripts Perl), eles são interpretados como parte do padrão. Cotações podem de
curso ser usado para delimitar padrões na linha de comando porque eles são interpretados pelo
shell e, de fato, aspas são necessárias se um padrão contém um espaço em branco ou shell
metacaracteres.

O primeiro argumento que segue qualquer configuração de opção é tratado como o único padrão a ser
combinou quando nenhum -e nem -f é presente. Por outro lado, quando uma ou ambas as opções
são usados ​​para especificar padrões, todos os argumentos são tratados como nomes de caminho. Pelo menos um de -e,
-f, ou um padrão de argumento deve ser fornecido.

Se nenhum arquivo for especificado, pcregrep lê a entrada padrão. A entrada padrão também pode
ser referenciado por um nome que consiste em um único hífen. Por exemplo:

pcregrep algum-padrão / arquivo1 - / arquivo3

Por padrão, cada linha que corresponde a um padrão é copiada para a saída padrão, e se
houver mais de um arquivo, o nome do arquivo é gerado no início de cada linha, seguido
por dois pontos. No entanto, existem opções que podem mudar como pcregrep se comporta. No
particular, o -M opção torna possível pesquisar padrões que abrangem a linha
limites. O que define um limite de linha é controlado pelo -N (--nova linha) opção.

A quantidade de memória usada para armazenar arquivos em buffer que estão sendo verificados é controlada por um
parâmetro que pode ser definido pelo --tamanho do buffer opção. O valor padrão para este
parâmetro é especificado quando pcregrep é construído, com o padrão sendo 20K. Um bloco
de memória três vezes este tamanho é usado (para permitir o buffer "antes" e "depois"
linhas). Ocorre um erro se uma linha estourar o buffer.

Os padrões não podem ter mais de 8K ou BUFSIZ bytes, o que for maior. BUFSIZ é
definido em . Quando há mais de um padrão (especificado pelo uso de -e
e / ou -f), cada padrão é aplicado a cada linha na ordem em que são definidos,
exceto que todo o -e padrões são experimentados antes do -f padrões.

Por padrão, assim que um padrão coincide com uma linha, nenhum outro padrão é considerado.
No entanto, se --cor (ou --cor) é usado para colorir as substrings correspondentes, ou se --só-
correspondente, --file-offsets, ou --line-offsets é usado para produzir apenas a parte da linha
que correspondeu (seja mostrado literalmente ou como um deslocamento), a digitalização é retomada imediatamente
após a correspondência, para que mais correspondências na mesma linha possam ser encontradas. Se houver
vários padrões, todos eles são testados no restante da linha, mas padrões que
siga aquele que correspondeu não são tentados na parte anterior da linha.

Este comportamento significa que a ordem em que vários padrões são especificados pode afetar
a saída quando uma das opções acima é usada. Este não é mais o mesmo comportamento que
GNU grep, que agora consegue exibir correspondências anteriores para padrões posteriores (contanto que
não há sobreposição).

Padrões que podem corresponder a uma string vazia são aceitos, mas as correspondências de strings vazias nunca são
reconhecido. Um exemplo é o padrão "(super)? (Homem)?", Em que todos os componentes são
opcional. Esse padrão encontra todas as ocorrências de "super" e "homem"; a saída difere
de correspondência com "super | man" quando apenas as substrings correspondentes estão sendo mostradas.

Se o LC_ALL or LC_CTYPE variável de ambiente está definida, pcregrep usa o valor para definir um
locale ao chamar a biblioteca PCRE. o --localidade opção pode ser usada para substituir isso.

zpcregrep é um script de wrapper que permite que pcregrep funcione em arquivos compactados gzip.

SUPPORT PARA COMPRIMIDO ARQUIVOS

É possível compilar pcregrep para que ele use libz or libbz2 ler arquivos cujo
nomes terminam em .gz or . Bz2, respectivamente. Você pode descobrir se o seu binário tem suporte
para um ou ambos os tipos de arquivo, executando-o com o --Socorro opção. Se o
não houver suporte apropriado, os arquivos serão tratados como texto simples. A entrada padrão é
sempre assim tratado.

BINARY ARQUIVOS

Por padrão, um arquivo que contém um byte zero binário dentro dos primeiros 1024 bytes é
identificado como um arquivo binário e é processado especialmente. (GNU grep também identifica binário
arquivos desta maneira.) Veja o --arquivos-binários opção por um meio de mudar a maneira
arquivos binários são tratados.

OPÇÕES

A ordem em que algumas das opções aparecem pode afetar a saída. Por exemplo, tanto o
-h e -l as opções afetam a impressão dos nomes dos arquivos. O que vier depois no comando
linha será aquela que entra em vigor. Da mesma forma, exceto onde indicado abaixo, se uma opção
é fornecido duas vezes, a configuração posterior é usada. Valores numéricos para opções podem ser seguidos por
K ou M, para significar a multiplicação por 1024 ou 1024 * 1024, respectivamente.

-- Isso encerra a lista de opções. É útil se o próximo item do
a linha de comando começa com um hífen, mas não é uma opção. Isso permite que o
processamento de padrões e nomes de arquivos que começam com hifens.

-A número, --after-context =número
saída número linhas de contexto após cada linha correspondente. Se nomes de arquivos e / ou
números de linha estão sendo produzidos, um separador de hífen é usado em vez de dois pontos para
as linhas de contexto. Uma linha contendo "-" é produzida entre cada grupo de linhas,
a menos que sejam de fato contíguos no arquivo de entrada. O valor de número is
espera-se que seja relativamente pequeno. Contudo, pcregrep garantias de ter até 8K
do seguinte texto disponível para saída de contexto.

-a, --texto
Trate os arquivos binários como texto. Isso é equivalente a --arquivos-binários=texto.

-B número, --before-context =número
saída número linhas de contexto antes de cada linha correspondente. Se nomes de arquivos e / ou
números de linha estão sendo produzidos, um separador de hífen é usado em vez de dois pontos para
as linhas de contexto. Uma linha contendo "-" é produzida entre cada grupo de linhas,
a menos que sejam de fato contíguos no arquivo de entrada. O valor de número is
espera-se que seja relativamente pequeno. Contudo, pcregrep garantias de ter até 8K
do texto anterior disponível para saída de contexto.

--binary-files =palavra
Especifique como os arquivos binários devem ser processados. Se a palavra for "binária" (o
padrão), a correspondência de padrões é realizada em arquivos binários, mas a única saída é
"Arquivo binário corresponde a "quando uma correspondência é bem-sucedida. Se a palavra for" texto ", que
é equivalente ao -a or --texto opção, os arquivos binários são processados ​​na mesma
forma como qualquer outro arquivo. Neste caso, quando uma correspondência for bem-sucedida, a saída pode ser
lixo binário, que pode ter efeitos desagradáveis ​​se enviado para um terminal. Se a palavra
é "sem correspondência", que é equivalente ao -I opção, os arquivos binários não são
processado em tudo; eles não são considerados de interesse.

--buffer-size =número
Defina o parâmetro que controla quanta memória é usada para armazenar arquivos que
estão sendo escaneados.

-C número, --context =número
saída número linhas de contexto antes e depois de cada linha correspondente. Esse
é equivalente a definir ambos -A e -B com o mesmo valor.

-c, --contar
Não produza linhas individuais dos arquivos que estão sendo verificados; em vez de
imprime o número de linhas que, de outra forma, seriam mostradas. Se nenhuma linha for
selecionado, o número zero é gerado. Se vários arquivos estiverem sendo verificados, um
contagem é a saída para cada um deles. No entanto, se o --arquivos com correspondências opção
também usado, apenas os arquivos cujas contagens são maiores que zero são listados. Quando
-c É usado, o -A, -B e -C opções são ignoradas.

--cor, --cor
Se esta opção for fornecida sem nenhum dado, é equivalente a "--colour = auto".
Se os dados forem necessários, eles devem ser fornecidos no mesmo item de shell, separados por um
é igual ao sinal.

--colour =valor, --color =valor
Esta opção especifica sob quais circunstâncias as partes de uma linha que correspondem
um padrão deve ser colorido na saída. Por padrão, a saída não é
colori. O valor (que é opcional, veja acima) pode ser "nunca", "sempre" ou
"auto". No último caso, a coloração acontece apenas se a saída padrão for
conectado a um terminal. Mais recursos são usados ​​quando a coloração está habilitada,
Porque pcregrep tem que pesquisar todas as correspondências possíveis em uma linha, não apenas uma,
a fim de colorir todos eles.

A cor que é usada pode ser especificada definindo a variável de ambiente
PCREGREP_COLOUR ou PCREGREP_COLOR. O valor desta variável deve ser uma string
de dois números separados por ponto e vírgula. Eles são copiados diretamente para o
string de controle para definir a cor em um terminal, por isso é sua responsabilidade
certifique-se de que eles fazem sentido. Se nenhuma das variáveis ​​de ambiente for definida, o
o padrão é "1; 31", que resulta em vermelho.

-D açao, --devices =açao
Se um caminho de entrada não for um arquivo regular ou um diretório, "ação" especifica como
deve ser processado. Os valores válidos são "ler" (o padrão) ou "ignorar" (silenciosamente
pule o caminho).

-d açao, --directories =açao
Se um caminho de entrada for um diretório, "ação" especifica como deve ser processado.
Os valores válidos são "ler" (o padrão em ambientes não Windows, para
compatibilidade com GNU grep), "recurse" (equivalente ao -r opção) ou "pular"
(ignore o caminho silenciosamente, o padrão em ambientes Windows). No "ler"
Nesse caso, os diretórios são lidos como se fossem arquivos comuns. Em algumas operações
sistemas o efeito de ler um diretório como este é um fim de arquivo imediato;
em outros, pode provocar um erro.

-e de cinto de segurança, --regex =de cinto de segurança, --regexp =de cinto de segurança
Especifique um padrão a ser correspondido. Esta opção pode ser usada várias vezes em ordem
para especificar vários padrões. Também pode ser usado como uma forma de especificar um único
padrão que começa com um hífen. Quando -e é usado, nenhum padrão de argumento é usado
na linha de comando; todos os argumentos são tratados como nomes de arquivo. Não há
limite para o número de padrões. Eles são aplicados a cada linha no pedido em
que são definidos até um jogo.

If -f é usado com -e, os padrões de linha de comando são combinados primeiro, seguidos por
os padrões do (s) arquivo (s), independente da ordem em que essas opções
são especificados. Observe que o uso múltiplo de -e não é o mesmo que um único padrão
com alternativas. Por exemplo, X | Y encontra o primeiro caractere em uma linha que é
X ou Y, enquanto se os dois padrões forem dados separadamente, com X primeiro, pcregrep
encontra X se estiver presente, mesmo se seguir Y na linha. Ele encontra Y apenas se
não há X na linha. Isso importa apenas se você estiver usando -o or --cor
para mostrar as partes da linha correspondentes.

--excluir=de cinto de segurança
Arquivos (mas não diretórios) cujos nomes correspondem ao padrão são ignorados sem
sendo processado. Isso se aplica a todos os arquivos, listados na linha de comando,
obtido de --lista de arquivos, ou verificando um diretório. O padrão é um PCRE
expressão regular e é comparada com o componente final do nome do arquivo,
não todo o caminho. o -F, -w e -x as opções não se aplicam a este padrão.
A opção pode ser dada qualquer número de vezes, a fim de especificar vários
padrões. Se um nome de arquivo corresponder a um --incluir e um --excluir padrão, isso
é excluído. Não existe um formato abreviado para esta opção.

--exclude-from =nome do arquivo
Trate cada linha não vazia do arquivo como os dados para um --excluir opção. O que
constitui uma nova linha ao ler o arquivo é o padrão do sistema operacional.
O --nova linha opção não tem efeito sobre esta opção. Esta opção pode ter mais
de uma vez para especificar um número de arquivos a serem lidos.

--excluir-dir=de cinto de segurança
Os diretórios cujos nomes correspondem ao padrão são ignorados sem serem processados,
qualquer que seja a configuração do --recursivo opção. Isso se aplica a todos os diretórios,
se listado na linha de comando, obtido de --lista de arquivos, ou digitalizando um
Diretório Parental. O padrão é uma expressão regular PCRE e é correspondido
em relação ao componente final do nome do diretório, não ao caminho inteiro. o -F,
-w e -x as opções não se aplicam a este padrão. A opção pode ser dada a qualquer
número de vezes para especificar mais de um padrão. Se um diretório
combina com ambos --include-dir e --excluir-dir, é excluído. Não há curto
formulário para esta opção.

-F, --strings fixas
Interprete cada padrão de correspondência de dados como uma lista de strings fixas, separadas por
novas linhas, em vez de uma expressão regular. O que constitui uma nova linha para
este propósito é controlado pelo --nova linha opção. O -w (corresponde a uma palavra) e
-x (coincidir com a linha inteira) opções podem ser usadas com -F. Eles se aplicam a cada um dos
cordas fixas. Uma linha é selecionada se qualquer uma das strings fixas for encontrada nela
(sujeito a -w or -x, se presente). Esta opção se aplica apenas aos padrões que
são comparados com o conteúdo dos arquivos; não se aplica a padrões
especificado por qualquer um dos --incluir or --excluir opções.

-f nome do arquivo, --file =nome do arquivo
Leia os padrões do arquivo, um por linha, e combine-os com cada linha de
entrada. O que constitui uma nova linha ao ler o arquivo é o funcionamento
padrão do sistema. o --nova linha opção não tem efeito sobre esta opção. Seguindo
o espaço em branco é removido de cada linha e as linhas em branco são ignoradas. Um vazio
o arquivo não contém padrões e, portanto, não corresponde a nada. Veja também os comentários
sobre vários padrões versus um único padrão com alternativas no
descrição de -e acima.

Se esta opção for fornecida mais de uma vez, todos os arquivos especificados serão lidos. Um dado
linha é produzida se algum dos padrões corresponder a ela. Um nome de arquivo pode ser fornecido como "-"
para se referir à entrada padrão. Quando -f é usado, os padrões especificados no
linha de comando usando -e também pode estar presente; eles são testados antes do arquivo
padrões. No entanto, nenhum outro padrão é obtido da linha de comando; tudo
argumentos são tratados como nomes de caminhos a serem pesquisados.

--lista de arquivos=nome do arquivo
Leia uma lista de arquivos e / ou diretórios que devem ser verificados em um determinado
arquivo, um por linha. O espaço em branco à direita é removido de cada linha e fica em branco
linhas são ignoradas. Esses caminhos são processados ​​antes de qualquer um que esteja listado no
linha de comando. O nome do arquivo pode ser fornecido como "-" para se referir à entrada padrão.
If --Arquivo e --lista de arquivos são especificados como "-", os padrões são lidos primeiro.
Isso é útil apenas quando a entrada padrão é um terminal, a partir do qual
linhas (a lista de arquivos) podem ser lidas após uma indicação de fim de arquivo. Se este
opção é fornecida mais de uma vez, todos os arquivos especificados são lidos.

--file-offsets
Em vez de mostrar linhas ou partes de linhas correspondentes, mostre cada correspondência como um
deslocamento do início do arquivo e um comprimento, separados por uma vírgula. Nisso
modo, nenhum contexto é mostrado. Ou seja, o -A, -B e -C opções são ignoradas. Se
há mais de uma correspondência em uma linha, cada uma delas é mostrada separadamente. Esse
opção é mutuamente exclusiva com --line-offsets e - apenas correspondendo.

-H, --com-nome do arquivo
Força a inclusão do nome do arquivo no início das linhas de saída ao pesquisar
um único arquivo. Por padrão, o nome do arquivo não é mostrado neste caso. Para combinar
linhas, o nome do arquivo é seguido por dois pontos; para linhas de contexto, um hífen
separador é usado. Se um número de linha também está sendo gerado, ele segue o arquivo
nome.

-h, --no-nome do arquivo
Suprima os nomes dos arquivos de saída ao pesquisar vários arquivos. Por padrão,
os nomes dos arquivos são mostrados quando vários arquivos são pesquisados. Para linhas correspondentes, o
o nome do arquivo é seguido por dois pontos; para linhas de contexto, um separador de hífen é usado.
Se um número de linha também estiver sendo gerado, ele seguirá o nome do arquivo.

--Socorro Produz uma mensagem de ajuda, dando breves detalhes das opções de comando e tipo de arquivo
suporte e, em seguida, saia. Qualquer outra coisa na linha de comando é ignorada.

-I Trate os arquivos binários como nunca coincidentes. Isso é equivalente a --binário-
arquivos=sem correspondência.

-i, --ignorar caso
Ignore as distinções entre maiúsculas e minúsculas durante as comparações.

--incluir=de cinto de segurança
Caso existam --incluir padrões são especificados, os únicos arquivos que são processados ​​são
aqueles que correspondem a um dos padrões (e não correspondem a um --excluir padronizar).
Esta opção não afeta os diretórios, mas se aplica a todos os arquivos, sejam
listado na linha de comando, obtido de --lista de arquivos, ou digitalizando um
diretório. O padrão é uma expressão regular PCRE, e é comparado com o
componente final do nome do arquivo, não o caminho inteiro. o -F, -w e -x
as opções não se aplicam a este padrão. A opção pode ser fornecida qualquer número de
vezes. Se um nome de arquivo corresponder a um --incluir e um --excluir padrão, é
excluídos. Não existe um formato abreviado para esta opção.

--include-from =nome do arquivo
Trate cada linha não vazia do arquivo como os dados para um --incluir opção. O que
constitui uma nova linha para este propósito é o padrão do sistema operacional. o
--nova linha opção não tem efeito sobre esta opção. Esta opção pode ser fornecida a qualquer
número de vezes; todos os arquivos são lidos.

--include-dir=de cinto de segurança
Caso existam --include-dir padrões são especificados, os únicos diretórios que são
processados ​​são aqueles que correspondem a um dos padrões (e não correspondem a um
--excluir-dir padronizar). Isso se aplica a todos os diretórios, listados no
linha de comando, obtida de --lista de arquivos, ou verificando um diretório pai. o
padrão é uma expressão regular PCRE, e é comparado com o componente final
do nome do diretório, não o caminho inteiro. o -F, -w e -x opções não
aplicar a este padrão. A opção pode ser fornecida quantas vezes forem necessárias. Se um
diretório corresponde a ambos --include-dir e --excluir-dir, é excluído. Há
nenhuma forma abreviada para esta opção.

-L, --arquivos-sem-correspondência
Em vez de gerar linhas dos arquivos, apenas imprima os nomes dos arquivos
que não contêm nenhuma linha que seria produzida. Cada nome de arquivo é
saída uma vez, em uma linha separada.

-l, --arquivos com correspondências
Em vez de gerar linhas dos arquivos, apenas imprima os nomes dos arquivos
contendo linhas que seriam geradas. Cada nome de arquivo é gerado uma vez, em
uma linha separada. A pesquisa normalmente para assim que uma linha correspondente for encontrada em
um arquivo. No entanto, se o -c (contagem) opção também é usada, a correspondência continua em
ordem para obter a contagem correta, e os arquivos que têm pelo menos uma correspondência
são listados junto com suas contagens. Usando esta opção com -c é uma forma de
suprimindo a lista de arquivos sem correspondências.

--rótulo=nome
Esta opção fornece um nome a ser usado para a entrada padrão quando os nomes dos arquivos
estão sendo produzidos. Se não for fornecido, "(entrada padrão)" é usado. Não há curto
formulário para esta opção.

--line-buffered
Quando esta opção é fornecida, a entrada é lida e processada linha por linha, e o
a saída é liberada após cada gravação. Por padrão, a entrada é lida em grandes blocos,
a menos que pcregrep pode determinar que está lendo de um terminal (que é
atualmente possível apenas em ambientes do tipo Unix). A saída para o terminal é
normalmente liberado automaticamente pelo sistema operacional. Esta opção pode ser
útil quando a entrada ou saída é anexada a um tubo e você não quer
pcregrep para armazenar grandes quantidades de dados. No entanto, seu uso afetará
desempenho, e o -M opção (multilinha) deixa de funcionar.

--line-offsets
Em vez de mostrar linhas ou partes de linhas correspondentes, mostre cada correspondência como uma linha
número, o deslocamento desde o início da linha e um comprimento. O número da linha é
terminado por dois pontos (como de costume; consulte o -n opção), e o deslocamento e comprimento
são separados por vírgula. Neste modo, nenhum contexto é mostrado. Ou seja, o -A,
-B e -C opções são ignoradas. Se houver mais de uma correspondência em uma linha, cada
deles é mostrado separadamente. Esta opção é mutuamente exclusiva com --Arquivo-
compensações e - apenas correspondendo.

--localidade=nome-local
Esta opção especifica um local a ser usado para correspondência de padrões. Ele substitui o
valor no LC_ALL or LC_CTYPE variáveis ​​ambientais. Se nenhuma localidade for
especificado, o padrão da biblioteca PCRE (geralmente o local "C") é usado. Há
nenhuma forma abreviada para esta opção.

--limite de correspondência=número
O processamento de alguns padrões de expressão regular pode exigir uma grande quantidade de
memória, levando em alguns casos a uma falha do programa se não houver disponibilidade suficiente.
Outros padrões podem levar muito tempo para pesquisar todas as correspondências possíveis
cordas. o pcre_exec () função que é chamada por pcregrep para fazer a correspondência
tem dois parâmetros que podem limitar os recursos que usa.

O --limite de correspondência opção fornece um meio de limitar o uso de recursos quando
padrões de processamento que não vão corresponder, mas que têm uma grande
número de possibilidades em suas árvores de pesquisa. O exemplo clássico é um padrão
que usa repetições ilimitadas aninhadas. Internamente, o PCRE usa uma função chamada
partida() que chama repetidamente (às vezes recursivamente). O limite estabelecido por
--limite de correspondência é imposto sobre o número de vezes que esta função é chamada durante um
correspondência, que tem o efeito de limitar a quantidade de retrocesso que pode levar
lugar.

O --limite de recursão opção é semelhante a --limite de correspondência, mas em vez de
limitando o número total de vezes que partida() é chamado, limita a profundidade
de chamadas recursivas, o que por sua vez limita a quantidade de memória que pode ser usada.
A profundidade de recursão é um número menor do que o número total de chamadas, porque
nem todas as chamadas para partida() são recursivos. Este limite é útil apenas se for definido
menor que --limite de correspondência.

Não existem formulários curtos para essas opções. As configurações padrão são especificadas
quando a biblioteca PCRE é compilada, com o padrão de 10 milhões.

-M, --multilina
Permita que os padrões correspondam a mais de uma linha. Quando esta opção é fornecida, os padrões
pode conter caracteres de nova linha literais e ocorrências internas de ^
e $ caracteres. A saída para uma correspondência bem-sucedida pode consistir em mais de um
linha, a última das quais é aquela em que a partida terminou. Se o combinado
string termina com uma sequência de nova linha, a saída termina no final dessa linha.

Quando esta opção é definida, a biblioteca PCRE é chamada no modo "multilinha". Lá
é um limite para o número de linhas que podem ser combinadas, imposto pela maneira que
pcregrep armazena o arquivo de entrada enquanto o verifica. Contudo, pcregrep Assegura que
pelo menos 8K caracteres ou o resto do documento (o que for mais curto)
estão disponíveis para correspondência direta e, da mesma forma, os 8K caracteres anteriores (ou
todos os caracteres anteriores, se menos de 8K) estão garantidamente disponíveis
para ver as afirmações ocultas. Esta opção não funciona quando a entrada é lida linha por
linha (ver --line-buffered.)

-N tipo de nova linha, --nova linha=tipo de nova linha
A biblioteca PCRE suporta cinco convenções diferentes para indicar os fins de
linhas. Eles são as sequências de um único caractere CR (retorno de carro) e LF
(alimentação de linha), a sequência de dois caracteres CRLF, uma convenção "anycrlf", que
reconhece qualquer um dos três tipos anteriores e uma convenção "qualquer", na qual
qualquer seqüência de final de linha Unicode é considerada como finalizando uma linha. As sequências Unicode
são os três que acabamos de mencionar, além de VT (guia vertical, U + 000B), FF (alimentação de formulário,
U + 000C), NEL (próxima linha, U + 0085), LS (separador de linha, U + 2028) e PS (parágrafo
separador, U + 2029).

Quando a biblioteca PCRE é construída, uma seqüência de finalização de linha padrão é especificada.
Normalmente, essa é a sequência padrão do sistema operacional. A não ser que
especificado de outra forma por esta opção, pcregrep usa o padrão da biblioteca. o
os valores possíveis para esta opção são CR, LF, CRLF, ANYCRLF ou ANY. Isso faz com que seja
possível usar pcregrep para escanear arquivos que vieram de outros ambientes
sem ter que modificar suas terminações de linha. Se os dados que estão sendo verificados
não concorda com a convenção definida por esta opção, pcregrep pode se comportar em
maneiras estranhas. Observe que esta opção não se aplica a arquivos especificados pelo -f,
--excluir-de, ou --incluir-de opções, que se espera que usem o
seqüência de nova linha padrão do sistema operacional.

-n, --número da linha
Preceda cada linha de saída por seu número de linha no arquivo, seguido por dois pontos para
linhas correspondentes ou um hífen para as linhas de contexto. Se o nome do arquivo também estiver sendo
saída, ele precede o número da linha. Esta opção é forçada se --line-offsets is
usava.

--no-jit Se a biblioteca PCRE for construída com suporte para compilação just-in-time (que
acelera a correspondência), pcregrep automaticamente faz uso disso, a menos que fosse
explicitamente desabilitado em tempo de construção. Esta opção pode ser usada para desabilitar o uso de
JIT em tempo de execução. É fornecido para teste e solução de problemas. Isto
nunca deve ser necessário em uso normal.

-o, - apenas correspondendo
Mostre apenas a parte da linha que correspondeu a um padrão, em vez de toda a linha.
Neste modo, nenhum contexto é mostrado. Ou seja, o -A, -B e -C opções são
ignorado. Se houver mais de uma correspondência em uma linha, cada uma delas será mostrada
separadamente. Se -o é combinado com -v (inverta o sentido da correspondência para encontrar
linhas não correspondentes), nenhuma saída é gerada, mas o código de retorno é definido
adequadamente. Se a parte correspondente da linha estiver vazia, nada será gerado
a menos que o nome do arquivo ou número da linha estejam sendo impressos, caso em que eles são
mostrado em uma linha vazia. Esta opção é mutuamente exclusiva com --Arquivo-
compensações e --line-offsets.

-onúmero, - apenas correspondendo=número
Mostra apenas a parte da linha que correspondeu aos parênteses de captura do
determinado número. Até 32 parênteses de captura são suportados, e -o0 é
equivalente a -o sem um número. Porque essas opções podem ser fornecidas sem um
argumento (veja acima), se um argumento estiver presente, ele deve ser dado no mesmo
item de shell, por exemplo, -o3 ou --only-matching = 2. Os comentários dados para o
o caso sem argumento acima também se aplica a este caso. Se a captura especificada
parênteses não existem no padrão, ou não foram colocados na correspondência, nada
é impresso, a menos que o nome do arquivo ou o número da linha estejam sendo impressos.

Se esta opção for fornecida várias vezes, várias substrings serão geradas, no
ordem as opções são fornecidas. Por exemplo, -o3 -o1 -o3 faz com que as substrings
correspondido pela captura dos parênteses 3 e 1 e, em seguida, 3 novamente para serem produzidos. Por
padrão, não há separador (mas veja a próxima opção).

--om-separador=texto
Especifique uma string de separação para várias ocorrências de -o. O padrão é um
string vazia. As sequências de separação nunca são coloridas.

-q, --quieto
Trabalhe silenciosamente, ou seja, não exiba nada, exceto mensagens de erro. O status de saída
indica se alguma correspondência foi encontrada ou não.

-r, --recursivo
Se qualquer caminho for um diretório, verifique recursivamente os arquivos que ele contém, tomando
nota de qualquer --incluir e --excluir definições. Por padrão, um diretório é lido como
um arquivo normal; em alguns sistemas operacionais, isso fornece um fim de arquivo imediato.
Esta opção é um atalho para definir o -d opção de "recurse".

--limite de recursão=número
See --limite de correspondência acima.

-s, --sem mensagens
Suprima mensagens de erro sobre arquivos inexistentes ou ilegíveis. Esses arquivos são
silenciosamente pulado. No entanto, o código de retorno ainda é 2, mesmo se as correspondências forem encontradas
em outros arquivos.

-u, --utf-8
Opere no modo UTF-8. Esta opção está disponível apenas se PCRE foi compilado
com suporte UTF-8. Todos os padrões (incluindo aqueles para qualquer --excluir e
--incluir opções) e todas as linhas de assunto digitalizadas devem ser strings válidas
de caracteres UTF-8.

-V, --versão
Escreva os números da versão de pcregrep e a biblioteca PCRE para o padrão
saída e depois saia. Qualquer outra coisa na linha de comando é ignorada.

-v, --invert-match
Inverta o sentido da correspondência, de modo que as linhas que não combinar com qualquer um dos
padrões são os que são encontrados.

-w, --palavra-regex, --palavra-regexp
Força os padrões para corresponderem apenas a palavras inteiras. Isso é equivalente a ter \ b em
o início e o fim do padrão. Esta opção se aplica apenas aos padrões que
são comparados com o conteúdo dos arquivos; não se aplica a padrões
especificado por qualquer um dos --incluir or --excluir opções.

-x, --line-regex, --line-regexp
Força os padrões a serem ancorados (cada um deve começar a combinar no início de
uma linha) e, além disso, exigem que correspondam a linhas inteiras. Isso é equivalente
ter ^ e $ caracteres no início e no final de cada ramificação alternativa em
cada padrão. Esta opção se aplica apenas aos padrões que são comparados
o conteúdo dos arquivos; não se aplica a padrões especificados por qualquer um dos
--incluir or --excluir opções.

MEIO AMBIENTE VARIÁVEIS

As variáveis ​​de ambiente LC_ALL e LC_CTYPE são examinados, nessa ordem, para um local.
O primeiro que é definido é usado. Isso pode ser substituído pelo --localidade opção. Se não
locale for definido, o padrão da biblioteca PCRE (geralmente o locale "C") será usado.

NOVAS LINHAS

O -N (--nova linha) opção permite pcregrep para escanear arquivos com diferentes convenções de nova linha
do padrão. Quaisquer partes dos arquivos de entrada que são gravadas na saída padrão são
copiados de forma idêntica, com quaisquer sequências de nova linha que eles tenham na entrada. No entanto, o
configuração desta opção não afeta a interpretação dos arquivos especificados pelo -f,
--excluir-de, ou --incluir-de opções, que presume-se que usem o sistema operacional
sequência de nova linha padrão, nem afeta a maneira como pcregrep escreve
mensagens informativas para o erro padrão e fluxos de saída. Para estes, usa o
string "\ n" para indicar novas linhas, contando com a biblioteca CI / O para convertê-lo em um
sequência apropriada.

OPÇÕES COMPATIBILIDADE

Muitas das formas curtas e longas de pcregrepas opções de são as mesmas do GNU grep
programa. Qualquer opção longa do formulário --xxx-regexp (Terminologia GNU) também está disponível como
--xxx-regex (Terminologia PCRE). No entanto, o --lista de arquivos, --file-offsets, --include-dir,
--line-offsets, --localidade, --limite de correspondência, -M, --multilina, -N, --nova linha, --om-separador,
--limite de recursão, -u e --utf-8 as opções são específicas para pcregrep, assim como o uso do
- apenas correspondendo opção com um número de parênteses de captura.

Embora a maioria das opções comuns funcionem da mesma maneira, algumas são diferentes em pcregrep.
Por exemplo, a --incluir o argumento da opção é um glob para GNU grep, mas um normal
expressão para pcregrep. Se ambos -c e -l opções são fornecidas, GNU grep lists only file
nomes, sem contagens, mas pcregrep dá as contas.

OPÇÕES COM DADOS

Existem quatro maneiras diferentes em que uma opção com dados pode ser especificada. Se um curto
opção de formulário for usada, os dados podem seguir imediatamente, ou (com uma exceção) no próximo
item de linha de comando. Por exemplo:

-f / algum / arquivo
-f / algum / arquivo

A exceção é o -o opção, que pode aparecer com ou sem dados. Por causa disso,
se houver dados, eles devem seguir imediatamente no mesmo item, por exemplo -o3.

Se uma opção de formato longo for usada, os dados podem aparecer no mesmo item de linha de comando,
separados por um caractere igual, ou (com duas exceções) pode aparecer no próximo
item de linha de comando. Por exemplo:

--file = / algum / arquivo
--file / some / file

Observe, no entanto, que se você deseja fornecer um nome de arquivo começando com ~ como dados em um shell
comando, e ter o shell expandir ~ para um diretório home, você deve separar o nome do arquivo
da opção, porque o shell não trata ~ especialmente, a menos que seja no início de
um item.

As exceções ao acima são os --cor (ou --cor) e - apenas correspondendo opções, para
cujos dados são opcionais. Se uma dessas opções tiver dados, eles devem ser fornecidos em
a primeira forma, usando um caractere de igual. De outra forma pcregrep vai assumir que não tem
dados.

COINCIDINDO ERROS

É possível fornecer uma expressão regular que leva muito tempo para não corresponder
certas linhas. Esses padrões normalmente envolvem repetições indefinidas aninhadas, por exemplo:
(a +) * \ d quando comparado com uma linha de a sem dígito final. A função de correspondência PCRE
tem um limite de recursos que faz com que seja abortado nessas circunstâncias. Se isso acontecer,
pcregrep exibe uma mensagem de erro e a linha que causou o problema para o padrão
fluxo de erro. Se houver mais de 20 desses erros, pcregrep desistir.

O --limite de correspondência opção de pcregrep pode ser usado para definir o limite geral de recursos; lá
é uma segunda opção chamada --limite de recursão que define um limite na quantidade de memória
(geralmente pilha) que é usado (consulte a discussão dessas opções acima).

DIAGNÓSTICO

O status de saída é 0 se qualquer correspondência for encontrada, 1 se nenhuma correspondência for encontrada e 2 para a sintaxe
erros, linhas muito longas, arquivos inexistentes ou inacessíveis (mesmo se as correspondências forem encontradas em
outros arquivos) ou muitos erros de correspondência. Usando o -s opção para suprimir mensagens de erro
sobre arquivos inacessíveis não afeta o código de retorno.

Use zpcregrep online usando serviços onworks.net