echo

  • Artigo

Exibe mensagens ou liga ou desliga o recurso de eco de comando. Se usado sem parâmetros, echo exibirá a configuração de eco atual.

Sintaxe

echo [<message>]
echo [on | off]

Parâmetros

Parâmetro Descrição
[on | off] Liga ou desliga o recurso de eco de comando. O eco de comando fica ligado por padrão.
<message> Especifica o texto a ser exibido na tela.
/? Exibe a ajuda no prompt de comando.

Comentários

  • O comando echo <message> é mais útil quando o echo está desligado. Para exibir uma mensagem com várias linhas sem exibir comandos, você pode incluir vários comandos echo <message> após o comando echo off em seu programa de lote.

  • Após echo ser desligado, o prompt de comando não aparece na janela do Prompt de Comando. Para exibir o prompt de comando, digite echo on.

  • Se usado em um arquivo de lote, echo on e echo off não afetam a configuração no prompt de comando.

  • Se houver uma variável vazia em um arquivo em lotes ao usar o echo, ela exibirá "ECHO is off". Para evitar receber essa mensagem e produzir uma linha em branco, coloque dois-pontos (:) entre o echo e a variável. Por exemplo, echo:%var%.

  • Para evitar o eco de um comando específico em um arquivo de lote, insira uma entrada (@) na frente do comando. Para evitar o eco de todos os comandos em um arquivo de lote, inclua o comando echo off no início do arquivo.

  • Para exibir um ponto de exclamação (!) em scripts de lote, coloque a palavra ou frase entre aspas duplas seguida por um acento circunflexo antes do ponto de exclamação ("Hello World^!"). Como alternativa, um acento circunflexo duplo (^^) pode ser usado sem a necessidade de aspas duplas (Hello World^^!).

  • Para exibir uma barra vertical (|), um E comercial (&) ou um caractere de redirecionamento (< ou >) quando estiver usando o echo, use um sinal de circunflexo (^) logo após esse caractere. Por exemplo: ^|, ^&, ^> ou ^<. Para exibir um circunflexo, digite dois circunflexos em sucessão (^^).

  • Quando estiver dentro de um bloco terminado por parênteses (()), ambos os parênteses de abertura e fechamento também devem ser escapados usando o acento circunflexo (^) imediatamente antes de cada um. Por exemplo, This is ^(now^) correct exibirá corretamente This is (now) correct.

Exemplos

Para exibir a configuração de echo atual, digite:

echo

Para ecoar uma linha em branco na tela, digite:

echo.

Observação

Não inclua um espaço antes do ponto final. Caso contrário, o ponto final será exibido em vez de uma linha em branco.

Para evitar o eco de comandos no prompt de comando, digite:

echo off

Observação

Quando echo for desligado, o prompt de comando não aparecerá na janela do Prompt de Comando. Para exibir o prompt de comando novamente, digite echo on.

Para impedir que todos os comandos em um arquivo de lote (incluindo o comando echo off) sejam exibidos na tela, na primeira linha do arquivo de lote, digite:

@echo off

Você pode usar o comando echo como parte de uma instrução if. Por exemplo, para pesquisar qualquer arquivo no diretório atual com a extensão de nome de arquivo .rpt e ecoar uma mensagem se esse arquivo for encontrado, digite:

if exist *.rpt echo The report has arrived.

O arquivo de lote a seguir pesquisa arquivos no diretório atual com a extensão de nome de arquivo .txt e exibe uma mensagem indicando os resultados da pesquisa:

@echo off
if not exist *.txt (
echo This directory contains no text files.
) else (
   echo This directory contains the following text file^(s^):
   echo.
   dir /b *.txt
   )

Se nenhum arquivo .txt for encontrado quando o arquivo de lote for executado, a seguinte mensagem será exibida:

This directory contains no text files.

Se arquivos .txt forem encontrados quando o arquivo de lote for executado, a seguinte saída será exibida (por exemplo, suponha que os arquivos File1.txt, File2.txt e File3.txt existam):

This directory contains the following text file(s):

File1.txt
File2.txt
File3.txt