echo

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

Syntaxe

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

Paramètres

Paramètre Description
[on | off] 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.

Notes

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

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

  • S’ils sont utilisés dans un fichier de traitement par lots, écho activé et écho désactivé n’affectent pas le paramètre à l’invite de commandes.

  • S’il existe une variable vide dans un fichier batch lors de l’utilisation de écho, elle affiche « ECHO est désactivé ». Pour empêcher l’affichage de ce message et produire une ligne vide à la place, placez un signe deux-points (:) entre écho et la variable. Par exemple, echo:%var%

  • Pour empêcher l’écho d’une commande particulière dans un fichier de traitement par lots, insérez une connexion (@) devant la commande. Pour empêcher l’écho de toutes les commandes dans un fichier de traitement par lots, incluez la commande écho désactivé au début du fichier.

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

  • Pour afficher un canal (|), une esperluette (&) ou un caractère de redirection (< ou >) lorsque vous utilisez écho, utilisez un accent circonflexe (^) immédiatement avant le caractère de canal ou le caractère de redirection. Par exemple, ^|, ^&, ^> ou ^<. Pour afficher un accent circonflexe, tapez sur deux accents circonflexes à la suite (^^).

  • À l'intérieur d'un bloc terminé par des parenthèses (()), les parenthèses ouvrantes et fermantes doivent également être échappées à l'aide du caret (^) immédiatement avant chacune d'elles. Par exemple, This is ^(now^) correct affichera correctement This is (now) correct.

Exemples

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

echo

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

echo.

Notes

N’incluez pas d’espace avant le point. Sinon, le point apparaît à la place d’une ligne vide.

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

echo off

Notes

Une fois écho désactivé, l’invite de commandes n’apparaît pas dans la fenêtre Invite de commandes. Pour afficher à nouveau l’invite de commandes, tapez écho activé.

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

@echo off

Vous pouvez utiliser la commande écho 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 de traitement par lots suivant recherche les fichiers avec l’extension de nom de fichier .txt dans le répertoire actif 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 fichier .txt n’est trouvé lors de l’exécution du fichier de traitement par lots, le message suivant s’affiche :

This directory contains no text files.

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

This directory contains the following text file(s):

File1.txt
File2.txt
File3.txt