Partilhar via

eco

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

Sintaxe

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

Parâmetros

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

Observações

  • O echo <message> comando é mais útil quando o echo está desligado. Para exibir uma mensagem com várias linhas sem exibir comandos, você pode incluir vários echo <message> comandos após o comando echo off no 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 lotes durante o uso do echo, ela exibirá "ECHO is off". Para evitar ver essa mensagem e, em vez disso, 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 lotes, 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 lote, envolva a palavra ou frase entre aspas duplas seguidas de um cursor antes do ponto de exclamação ("Hello World^!"). Alternativamente, um duplo acento circunflexo (^^) pode ser usado sem a necessidade de aspas duplas (Hello World^^!).

  • Para exibir um pipe (|), e comercial (&) ou um caractere de redirecionamento (< ou >) quando estiver usando echo, use um cursor (^) imediatamente antes desse caractere. Por exemplo, ^|, , ^&^>, ou ^<. Para exibir um cursor, digite dois acento circunflexos sucessivamente (^^).

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

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 ponto aparece em vez de uma linha em branco.

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

echo off

Observação

Quando o eco 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 no diretório atual qualquer arquivo com a extensão de nome de arquivo .rpt e para ecoar uma mensagem se esse arquivo for encontrado, digite:

if exist *.rpt echo The report has arrived.

O seguinte ficheiro batch procura ficheiros no diretório atual com a extensão de nome de ficheiro .txt e apresenta uma mensagem que indica 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 em lotes for executado, a seguinte mensagem será exibida:

This directory contains no text files.

Se .txt arquivos forem encontrados quando o arquivo em lotes for executado, a seguinte saída será exibida (por exemplo, suponha que os arquivos File1.txt, File2.txte File3.txt existem):

This directory contains the following text file(s):

File1.txt
File2.txt
File3.txt