FIND
Procura uma sequência de texto específica em um arquivo ou arquivos.
Depois de pesquisar os arquivos especificados, o FIND exibe as linhas de texto que contêm a sequência especificada.
Sintaxe :
FIND [/V] [/C] [/N] [/I] "sequência" [[unidade:][caminho]nome-de-arquivo[...]]
Parâmetros :
"sequência"
Especifica o grupo de caracteres a ser procurado. é preciso incluir o texto da sequência entre aspas.
[unidade:][caminho]nome-de-arquivo
Especifica a localização e o nome do arquivo no qual deve ser procurada a sequência especificada.
Opções :
/V
Exibe todas as linhas que não contêm a sequência especificada.
/C
Exibe somente uma contagem das linhas que contêm a sequência especificada.
/N
Precede cada linha com o número da linha no arquivo.
/I
Especifica que a busca não faça distinção entre maiúsculas e minúsculas.
Observações :
Especificando uma sequência :
A menos que seja especificada a opção /I, o FIND procura exatamente o que foi especificado como sequência. Por exemplo, para o comando FIND, os caracteres "a" e "A" são diferentes. Se for usada a opção /I, porêm, o FIND ignora a diferença entre maiúscula e minúscula e procura "a" e "A" como se fossem o mesmo caractere.
Caso a sequência a ser procurada contenha aspas, ser necessário usar duas
Usando FIND como filtro :
Se o nome-de-arquivo for omitido, o FIND atua como filtro, recebendo entrada da origem padrão do MS-DOS (geralmente teclado, conexão ou arquivo redirecionado) e exibindo as linhas que contêm a sequência.
Usando curingas com o FIND :
Não é possível usar curingas (* e ?) em nomes-de-arquivo ou extensões especificadas com o comando FIND. Para procurar uma sequência em um grupo de arquivos especificados com curingas, pode-se usar o comando FIND em um comando FOR.
Usando a opção /V ou /N com a op‡ao /C :
Se forem especificadas as opções /C e /V no mesmo comando, FIND exibirá uma contagem das linhas que não contêm a sequência especificada. Se forem especificados as opções /C e /N no mesmo comando, FIND ignora a opção /N.
Usando FIND em comandos com retornos de carro :
O comando FIND não reconhece retornos de carro. Quando se usa FIND para procurar uma sequência de texto num arquivo que inclui retornos de carro, é preciso limitar a sequência procurada a uma porção de texto que possa ser encontrada entre retornos de carro, isto é uma sequência que não deva ter sido interrompida por um retorno de carro. Por exemplo, o FIND não encontra coincidência para a sequência "arquivo de impostos" nos locais onde ocorre retorno de carro entre "arquivo" e "de impostos".
Códigos de saída do FIND :
A lista a seguir mostra os diversos códigos de saída, acompanhados de uma breve descrição de seu significado:
0
A busca foi completada com sucesso e foi encontrada pelo menos uma coincidência.
1
A busca for completada com sucesso, mas não foram encontradas coincidências.
2
A busca não foi completada com sucesso. Neste caso, ocorreu um erro durante a pesquisa, e o FIND não consegue informar se foram encontradas coincidências.
O parâmetro ERRORLEVEL pode ser usado na linha de comando <If> de um programa de lote para processar códigos de saída devolvidos pelo FIND.
Exemplos :
Para exibir todas as linhas do arquivo CANETA.AD que contém a sequência "Canetas coloridas", digite o seguinte comando.
find "Canetas coloridas" caneta.ad
Para encontrar a sequência que contém texto entre aspas, é preciso incluir toda a sequência entre aspas e, além disso, usar duas aspas para cada sinal individual contido dentro da sequência, como mostra o exemplo a seguir:
find "Os cientistas marcaram seu trabalho como ""somente para discussão."" Não considere como relatório final." relat.doc
Para pesquisar um grupo de arquivos, o comando FIND pode ser usado com o comando FOR. O comando a seguir usa este método para pesquisar, no diretório atual, os arquivos com a extensão .BAT; em cada arquivo encontrado, o comando procura a sequência "AVISO":
for %f in (*.bat) do find "AVISO" %f
Suponhamos que você queira que FIND pesquise seu disco rígido para encontrar e exibir os nomes-de-arquivo da unidade C que contenham a sequência "CPU". Para fazê-lo, é possível usar o sinal de conexao (|) para direcionar os resultados de um comando DIR para FIND, como mostra o exemplo a seguir:
dir c:\ /s /b | find "CPU"
Antes de usar uma conexão para redirecionamento, é preciso definir a variável do ambiente TEMP do arquivo AUTOEXEC.BAT.
Como as buscas de FIND diferenciam letras maiúsculas e minúsculas, e como DIR produz saída em letras maiúsculas, é necessário digitar a sequência "CPU" em letras maiúsculas ou usar a opção /I com FIND.