message Texte à afficher.

 

Voir aussi les commandes ECHOS, ECHOSERR, ECHOERR, ECHOX, ECHOXERR, SCREEN, SCRPUT, TEXT et VSCRPUT, ainsi que la variable interne _ECHO.

 

Utilisation :

 

La commande ECHO a deux objectifs distincts, fonctionnant indépendamment l'un de l'autre :

 

•l'écho de la ligne de commande

•Affichage de messages

 

Écho de la ligne de commande

 

Lorsque l'écho de la ligne de commande est activé, chaque commande est affichée sur stdout après avoir été entièrement analysée, les alias, les fonctions et les variables développés, mais avant d'être exécutée.

 

Contrôle de l'écho

 

TCC contrôle l'écho de la ligne de commande dans les fichiers batch et à l'invite interactive de manière indépendante.

 

L'exécution de ECHO ON à l'invite de commande active et ECHO OFF désactive l'écho à l'invite de commande. Par défaut, ECHO est désactivé sur la ligne de commande. L'ECHO de la ligne de commande est surtout utile lorsque vous apprenez à utiliser des fonctions avancées.

 

De même, l'exécution de ECHO ON dans un fichier batch active et ECHO OFF désactive l'écho des commandes du fichier batch. Lavaleur par défaut de ECHO est ON dans lesfichiers de lots . L'état actuel de l'ECHO est hérité par les fichiers batch appelés. Vous pouvez changer le paramètre par défaut à OFF avec la  commande SETDOS /V0, ou l' option de configuration Batch Echo.

 

Quel que soit l'état de l'écho, toute commande précédée du signe @ ne sera pas répercutée.

 

Affichage de l'état de l'écho

 

Pour connaître l'état actuel de l'écho, utilisez la commande ECHO sans paramètres. Cette commande affiche l'état de l'écho du fichier batch ou de la ligne de commande, en fonction de l'endroit où la commande ECHO est exécutée. Vous pouvez également examiner la valeur de la variable interne _ECHO.

 

Affichage du message

 

Si la commande ECHO a un message (toute la queue de la commande, à l'exclusion de la redirection ou de la tuyauterie, le cas échéant), et que le message n'est ni ON ni OFF (bien qu'il puisse inclure ces mots), le message est entièrement analysé, puis affiché sur stdout, quel que soit l'état de l'écho applicable. Tout affichage envoyé à stdout après l'affichage du message commencera sur une nouvelle ligne.

 

Règles d'affichage

 

•Le premier espace après le nom de la commande est ignoré.

•Lesespaces de fin de message sont ignorés.

•Les fonctions et les variables qui ne sont pas placées entre guillemets sont évaluées.

•Pour inclure des caractères spéciaux, par exemple < | >, dans le message, mettez-les entre guillemets doubles ou entre guillemets inversés (voir Citations des paramètres) ou faites-les précéder du caractère d'échappement, ou utilisez l'option /X de la  commande SETDOS.

•Pour afficher les %, vous pouvez utiliser alternativement deux  marques % pour chaque % à afficher, par exemple, %%%.

•Pour afficher les espaces de fin, mettez-les entre guillemets ou ajoutez une paire de guillemets derrière eux, par exemple, echo trailers ``.

•Le  caractère ASCII NULne peut pas être inclus dans un message.

•Si stdout est la console, après avoir affiché le message sur la ligne courante, le curseur sera déplacé au début de la ligne suivante.

•Si stdout est un fichier, la séquence CR LF sera ajoutée au message.

 

Pour afficher une ligne vide, utilisez l'un des formulaires ci-dessous :

 

 echo ``        (deux guillemets consécutifs), ou

 echo.                (syntaxe spéciale pour la compatibilité avec CMD).

 

Exemples :

 

Cette commande affiche un message :

 

echo Processing your print files...

 

La commande

 

echo This text is indented 3 spaces ``

 

affichera 3 espaces en tête et 3 espaces en queue.