Partager via

écho

Affiche des messages ou active ou désactive la fonctionnalité d’écho de commande. Si elle est utilisée sans paramètres, l’écho affiche le paramètre d’écho actuel.

Syntaxe

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

Paramètres

Paramètre Descriptif
[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.

Remarques

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

  • Une fois l’é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é.

  • Si elle est utilisée dans un fichier de commandes, l’écho activé et l’é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 l’é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 l’écho 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 empêcher l’écho de 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 un canal (|), un ampersand (&) ou un caractère de redirection (< ou >) lorsque vous utilisez un écho, utilisez un point^ () juste 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.

Exemples

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

echo

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

echo.

Remarque

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

Remarque

Lorsque l’écho est 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 dans un fichier batch (y compris la commande echo off ) à l’écran, 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