echo

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

Syntax

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

Parameters

Parameter Description
[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.

Remarks

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

  • Depois que o echo é desativado, 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 em lotes, 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 lote ao usar echo, ele exibirá "ECHO está desativado". Para evitar ver essa mensagem e, em vez disso, produzir uma linha em branco, coloque dois-pontos (:) entre echo 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 o eco de todos os comandos em um arquivo em lotes, 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 uma barra vertical (|), um "comercial&" () ou um caractere de redirecionamento (< ou >) quando você estiver usando echo, 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.

Examples

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

echo

Para ecoar uma linha em branco na tela, digite:

echo.

Note

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

Note

Quando o echo está desativado, o prompt de comando não aparece 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 em lotes (incluindo o comando echo off ) sejam exibidos na tela, na primeira linha do tipo de arquivo em lotes:

@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