FOR |
Pour |
|---|---|
| Zenith Data Systems Microsoft MS-DOS 2 | Interne |
Syntaxe
| FOR %%variable IN (set) DO command |
| FOR %variable IN (set) DO command |
Paramètres
| Nom | Description |
|---|---|
| variable | Ce paramètre permet d'indiquer une variable correspondant à un paramètre remplaçable pouvant être n'importe quel caractère sauf 0, 1, 2, 3, .. 9 - pour éviter la confusion avec les paramètres %0-%9 du traitements par lots. |
| IN | Ce paramètre permet d'indiquer un opérateur sous la commande FOR instruisant pour ce que (set) peut effectuer avec la commande. |
| set | Ce paramètre permet d'indiquer l'une des opérations suivantes : (filespec...) (pathname...) (filename...) (ASCII character string...) (afn) où afn est un nom de fichier ambigu utilisant des caractères génériques tels que «*» et/ou «?», et où peut être uniquement inclus dans (set). |
| DO | Ce paramètre permet d'indiquer un opérateur sous la commande FOR indiquant la commande command à exécuter. |
| command | Ce paramètre permet d'indiquer toute commande MS-DOS valide. |
Description
Cette commande permet d'effectuer le traitement d'un groupe de fichier à une commande.
Remarque
- La commande FOR est utilisée pour répéter une commande MS-DOS pendant le fichier de traitement par lot et le traitement de fichiers interactifs.
Concepts préliminaires
Les commandes résidentes et de traitement par lots sont le plus souvent exécutées à partir d'un fichier de traitement par lots, bien qu'ils puissent être utilisés directement à partir de la ligne de commande dans certains cas.
Remarque : vous devez toujours terminer chaque ligne d'un fichier de traitement par lots en appuyant sur la touche RETURN.
La %%variable est attribuée séquentiellement à chaque membre de (set), et la command est exécuté pour chaque membre de (set). Si un membre de set est une expression impliquant les caractères génériques, «*» et/ou «?», la variable est définie sur chaque modèle de correspondance (pouvant être un nom de fichier) à partir du disque. Dans ce cas d'un nom de fichier ambigu, (set) ne peut inclure un seul membre, et tout membre de (set) en plus du premier sera ignoré.
Remarque : si (set) est un nom de fichier ambigu (afn), il ne peut pas aussi être un nom de chemin.
Entrée de la ligne de commande
La commande FOR est entrée, suivie des paramètres énumérés ci-dessous :
Le paramètre variable peut être n'importe quel caractère sauf 0, 1, 2, 3, ..., 9 - pour éviter la confusion avec les paramètres remplaçables %0-%9.
Le paramètre (set) peut être l'un des paramètres répertoriés sous les formulaires d'entrée et peut également être une liste de ces paramètres. Lorsque vous utilisez une liste dans (set), vous devez séparer chaque membre avec un espace, et vous ne pouvez pas dépasser une longueur de ligne totale de 128 caractères.
Remarque : Le paramètre (set) doit être enfermé entre parenthèses.
La %%variable est définie séquentiellement à chaque nombre de (set). Si un membre de (set) est une expression contenant «*» et/ou «?», alors la variable est définie sur chaque ensemble de correspondance sur le disque.
Le paramètre command peut être n'importe quelle commande MS-DOS valide.
Utilisation du traitement interactif
Si vous vouliez afficher les répertoires d'un certain nombre de programmes, vous entreriez la commande :
| FOR %f IN (programx.asm programy.asm programz.asm) DO DIR %f |
et appuyez sur la touche RETURN. L'écran afficherait ensuite les répertoires des trois programmes suivants, en séquence :
|
programx.asm programy.asm programz.asm |
Utilisation du traitement des fichiers par lots
Si vous vouliez créer un fichier de traitement par lots exécutant la commande PRINT pour chaque fichier du répertoire ayant l'extension .LST, vous incluriez la ligne de commande suivante dans votre fichier de traitement par lots :
| FOR %%f IN (*.LST) DO PRINT %%f |
Le «%%» est nécessaire pour qu'après le traitement des paramètres par lots soit terminé, il reste un «%». Si seulement '%f' était là, le processeur système verrait le «%», examinerait «f», décider que «%f» était une erreur (mauvaise référence de paramètre) et jeter le «%f», de sorte que la commande FOR ne le verrait jamais. Si le FOR n'est pas dans un fichier de traitement par lots, un seul «%» doit être utilisé (comme dans l'exemple sous traitement interactif).
Remarque : une seule commande FOR peut être spécifiée par ligne de commande.
Messages d'erreur
| Invalid number of paramters |
Explication : Ce message sera affiché si vous avez laissé de côté l'un des paramètres de commande ou que vous avez essayé d'entrer plus d'une commande FOR par ligne de commande. Réentrez la commande à nouveau.
| Syntax error |
Explication : Ce message sera affiché si vous n'avez pas suivi les règles de syntaxe spécifiques pour saisir cette commande. Réentrez la ligne de commande.