APPLY

Syntaxe

Paramètres

Description

Cette commande permet d'effectuer des commandes à plusieurs reprises avec des paramètres différents à chaque fois.

Remarques

• L'entrée standard MS-DOS est la source par défaut pour APPLY.
• Pour utiliser cette commande avec succès, un fichier COMMAND.COM valide doit se trouver sur l'unité de disque par défaut.

Concepts préliminaires

La commande APPLY vous permet d'exécuter plusieurs fois une commande spécifiée à l'aide de paramètres ou d'entrées provenant de la source spécifiée. La source par défaut est l'entrée standard. Cette commande peut être utilisée avec des canaux pour recevoir l'entrée d'une autre commande ou fonction MS-DOS.

Lorsque vous spécifiez un fichier comme entrée pour APPLY, APPLY lit les lignes du fichier spécifié, remplace les lignes par un paramètre dans la commande que vous spécifiez et exécute la commande une fois pour chaque substitution de paramètre. Essentiellement, APPLY provoque l'exécution de la commande que vous spécifiez une fois pour chaque ligne d'entrée. Si vous ne spécifiez pas de source, l'entrée standard sera utilisée comme paramètre(s) dans la commande spécifiée.

Lors de l'exécution de la commande APPLY, le nom de la commande en cours d'exécution via APPLY et le paramètre actuellement utilisé dans la commande sont affichés.

Entrée de ligne de commande

Les paramètres de ligne de commande requis pour appeler la commande APPLY sont décrits ci-dessous. Appuyez sur la BARRE D'ESPACE ou utilisez un délimiteur MS-DOS équivalent entre les paramètres entrés dans le cadre d'une ligne de commande APPLY.

Vous devez toujours spécifier la commande que vous souhaitez appliquer à la source par défaut ou spécifiée. Cependant, l'ordre dans lequel vous spécifiez le paramètre source et le paramètre de commande n'a pas d'importance, tant qu'ils suivent tous les deux le nom de la commande, APPLY.

Spécification des sources

Si vous ne voulez pas qu'APPLY lise l'entrée standard, vous devez spécifier la source à lire et à partir de quels paramètres seront substitués dans la commande que vous choisissez pour l'exécution. Vous pouvez spécifier l'un des éléments suivants comme source d'entrée pour APPLY :

• [d:]filename, si vous voulez un fichier, le répertoire courant du disque par défaut ou spécifié doit être lu en entrée.
• [d:]pathname, si vous voulez qu'un fichier dans un répertoire autre que le répertoire courant du disque par défaut ou spécifié soit lu en entrée.

Dans les deux cas, si le fichier ne se trouve pas sur le disque par défaut, vous devez spécifier le nom d'unité de disque approprié (d:) dans le cadre de la spécification source.

Si vous souhaitez que APPLY lise l'entrée standard, vous pouvez soit ne spécifier aucun paramètre source, soit spécifier un trait d'union (-) comme paramètre source. Autrement dit, vous pouvez saisir une commande sous la forme :

ou

et APPLY lira l'entrée standard comme sa source. L'entrée standard par défaut est le clavier ; l'entrée standard peut être sortie d'une autre commande lorsque des canaux et/ou une redirection d'entrée/sortie sont utilisés. Ainsi, les formats d'entrée ci-dessus peuvent être utilisés lorsque l'entrée à APPLY est canalisée à partir d'une autre commande MS-DOS.

Comme l'entrée d'un fichier, l'entrée standard est lue ligne par ligne et chaque ligne est utilisée une fois comme paramètre dans la commande que vous exécutez via APPLY.

Commande

Vous devez toujours spécifier la commande à exécuter à l'aide de l'entrée APPLY ; il n'y a pas de commande par défaut. La commande que vous spécifiez doit être placée entre guillemets et doit être une commande MS-DOS valide. La commande doit respecter les exigences d'entrée de ligne de commande lui étant applicables, à condition que vous puissiez représenter un paramètre (ou une partie d'un paramètre, comme cela peut être le cas avec les spécifications de fichier) avec le caractère % désignant une variable. Sinon, il n'y a pas de restrictions ou d'exigences pour le paramètre de commande.

La commande que vous spécifiez sera exécutée une fois pour chaque ligne d'entrée à APPLY, où la ligne est remplacée par un paramètre de commande désigné par %. C'est-à-dire que les occurrences de % dans la commande seront remplacées par une ligne à la fois de l'entrée à APPLY. La commande sera exécutée après chaque substitution de paramètre.

Exemples

Supposons que vous ayez le fichier ALLBAK.FIL sur le disque dans l'unité de disque B et que ce fichier se compose de tous les fichiers .BAK sur ce disque. Si vous souhaitez copier tous les fichiers .BAK sur un autre disque pour les entreposer, puis les supprimer de votre disque de travail, vous pouvez effectuer les opérations suivantes :

• Au prompt du système, entrez :

APPLY B:ALLBAK.FIL "COPY B:% C:"

et presser sur RETURN.

• Le système commencera à copier tous les fichiers répertoriés dans le fichier ALLBAK.FIL du disque du lecteur B vers l'unité de disque C. Chaque fois que la commande COPY est exécutée, l'écran affiche :

COPY B:filename.BAK C:

où filename est le nom de fichier principal du fichier en cours de copie. Une fois qu'un fichier donné a été copié avec succès, l'écran affiche :

1 File(s) copied

avant de passer au fichier suivant répertorié dans ALLBAK.FIL.

• Lorsque tous les fichiers répertoriés dans le fichier ALLBAK.FIL ont été copiés, l'invite système s'affiche à nouveau.
• Pour supprimer les fichiers .BAK de votre disque de travail, entrez :

APPLY B:ALLBAK.FIL "ERASE %"

et presser sur RETURN.

• Le système commencera à supprimer tous les fichiers répertoriés dans le fichier ALLBAK.FIL du disque dans l'unité de disque B. Chaque fois que la commande ERASE est exécutée, l'écran affiche :

ERASE B:filename

où filename est le nom de fichier principal du fichier en cours de suppression.

• Lorsque tous les fichiers répertoriés dans le fichier ALLBAK.FIL ont été supprimés, au prompt système s'affiche à nouveau.

Messages d'erreurs

EXPLICATION : Ce message s'affiche si vous avez tenté d'exécuter APPLY sans disposer d'un fichier COMMAND.COM valide sur le disque de l'unité de disque par défaut. Ce fichier doit être disponible sur le disque par défaut pour que APPLY s'exécute.

EXPLICATION : Ce message s'affiche si vous saisissez un nom de fichier ou un chemin d'accès non valide, ou si le système ne parvient pas à localiser la source que vous avez saisie sur le disque spécifié. Entrez à nouveau la commande APPLY, en vous assurant que la source est spécifiée correctement et qu'elle est disponible sur le disque approprié.

Code source

Voici des exemples de code source de APPLY :