echo

Affiche des messages ou active ou désactive la fonctionnalité d’écho de commande. S’il est utilisé sans paramètres, echo affiche le réglage actuel de l’écho.

Syntax

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

Parameters

Parameter Description
[activé | désactivé] Active ou désactive la fonctionnalité d’écho de commande. L’écho de commande est activé par défaut.
<message> Spécifie le texte à afficher à l’écran.
/? Affiche l'aide à l'invite de commandes.

Remarks

  • La echo <message> commande est plus utile lorsque l’écho est désactivé. Pour afficher un message de plusieurs lignes sans afficher de commandes, vous pouvez inclure plusieurs echo <message> commandes après la commande echo off dans votre programme de traitement par lots.

  • Une fois l’écho désactivé, l’invite de commande n’apparaît pas dans la fenêtre d’invite de commande. Pour afficher l’invite de commande, tapez echo on.

  • S’ils sont utilisés dans un fichier batch, echo on et echo off n’affectent pas le paramètre à l’invite de commande.

  • S’il y a une variable vide dans un fichier batch lors de l’utilisation d’echo, il affiche « ECHO is off ». Pour éviter de voir ce message et produire une ligne vide à la place, placez un deux-points (:) entre echo et la variable. Par exemple : echo:%var%.

  • Pour empêcher l’écho d’une commande particulière dans un fichier batch, insérez une connexion (@) devant la commande. Pour éviter de faire écho à toutes les commandes d’un fichier batch, incluez la commande echo off au début du fichier.

  • Pour afficher un point d’exclamation (!) dans les scripts de traitement par lots, encapsulez le mot ou l’expression entre guillemets doubles suivis d’un point d’exclamation avant le point d’exclamation ("Hello World^!"). Vous pouvez également utiliser un point d’insertion double (^^) sans avoir besoin de guillemets doubles (Hello World^^!).

  • Pour afficher une barre verticale (|), une esperluette (&) ou un caractère de redirection (< ou >) lorsque vous utilisez echo, utilisez un curseur (^) immédiatement avant ce caractère. Par exemple, ^|, ^&, ^> ou ^<. Pour afficher un caret, tapez deux caresses en succession (^^).

  • Lorsqu’à l’intérieur d’un bloc se termine par des parenthèses (()), les parenthèses ouvrantes et fermante doivent également être échappées à l’aide de la touche (^) immédiatement avant chacune d’elles. Par exemple, This is ^(now^) correct l’affichage This is (now) correctest correct.

Examples

Pour afficher le paramètre d’écho actuel, tapez :

echo

Pour faire écho à une ligne vide à l’écran, tapez :

echo.

Note

N’incluez pas d’espace avant la période. Sinon, la période apparaît au lieu d’une ligne vide.

Pour empêcher l’écho des commandes à l’invite de commandes, tapez :

echo off

Note

Lorsque l’écho est désactivé, l’invite de commande n’apparaît pas dans la fenêtre d’invite de commande. Pour afficher à nouveau l’invite de commande, tapez echo on.

Pour empêcher l’affichage à l’écran de toutes les commandes d’un fichier batch (y compris la commande echo off ), sur la première ligne du type de fichier batch :

@echo off

Vous pouvez utiliser la commande echo dans le cadre d’une instruction if . Par exemple, pour rechercher dans le répertoire actif un fichier avec l’extension de nom de fichier .rpt et pour faire écho à un message si un tel fichier est trouvé, tapez :

if exist *.rpt echo The report has arrived.

Le fichier batch suivant recherche dans le répertoire actif les fichiers avec l’extension de nom de fichier .txt et affiche un message indiquant les résultats de la recherche :

@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
   )

Si aucun .txt fichiers n’est trouvé lorsque le fichier batch est exécuté, le message suivant s’affiche :

This directory contains no text files.

Si .txt fichiers sont trouvés lorsque le fichier batch est exécuté, la sortie suivante s’affiche (pour cet exemple, supposons que les fichiers File1.txt, File2.txtet File3.txt existent) :

This directory contains the following text file(s):

File1.txt
File2.txt
File3.txt