Compartilhar via

eco

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

Sintaxe

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

Parâmetros

Parâmetro Descrição
[ativado | desativado] Ativa ou desativa o recurso de eco de comando. O eco de comando está ativado por padrão.
<message> Especifica o texto a ser exibido na tela.
/? Exibe a ajuda no prompt de comando.

Observações

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

  • Depois que o eco é desativado, o prompt de comando não aparece na janela prompt de comando. Para exibir o prompt de comando, digite eco.

  • Se usado em um arquivo em lote, o eco ativado e o eco desativado não afetam a configuração no prompt de comando.

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

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

  • Para exibir um ponto de exclamação (!) em scripts em lotes, embrulhe a palavra ou a frase em aspas duplas seguidas por um cursor antes do ponto de exclamação ("Hello World^!"). Como alternativa, um cursor duplo (^^) pode ser usado sem a necessidade de aspas duplas (Hello World^^!).

  • Para exibir um pipe (|), escarpa (&) ou caractere de redirecionamento (< ou >) quando estiver usando o eco, use um cursor (^) imediatamente antes desse caractere. Por exemplo, ^|, ^&, ^> ou ^<. Para exibir um cursor, digite dois conjuntos em sucessão (^^).

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

Exemplos

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

echo

Para ecoar uma linha em branco na tela, digite:

echo.

Observação

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

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

echo off

Observação

Quando o eco é desativado, o prompt de comando não aparece na janela prompt de comando. Para exibir o prompt de comando novamente, digite eco.

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

@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 em lote a seguir pesquisa o diretório atual em busca de arquivos 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 .txt arquivos for encontrado quando o arquivo em lote for executado, a seguinte mensagem será exibida:

This directory contains no text files.

Se .txt arquivos forem encontrados quando o arquivo em lote for executado, as seguintes exibições de saída (para este exemplo, suponha que os arquivos File1.txt, File2.txte File3.txt existam):

This directory contains the following text file(s):

File1.txt
File2.txt
File3.txt