« DOS/For » : différence entre les versions

La commande FOR utilise une ou plusieurs variables locales pour effectuer la boucle. Dans le cas d'une commande entrée directement sous DOS, il faut les utiliser avec un simple <tt>%</tt>, alors que si la commande est utilisée dans un fichier batch .bat, il faudra l'utiliser avec <tt>%%</tt>. Dans la suite, les descriptions d'utilisation utiliseront un simple <tt>%</tt>, et les exemples, généralement destinés à être intégrés dans un fichier de commandes, auront les variables notées avec <tt>%%</tt>

 

Ces boucles s'utilisent pour appliquer une commande à plusieurs fichiers. Au lieu de copier plusieurs fois la même commande pour un fichier, le FOR permet de n'écrire cette commande qu'une seule fois. Ceci est surtout utile si la commande est complexe.

 

FOR %''variable'' IN (''ensemble de fichiers'') DO ''commande''

 

Pour ce cas, le FOR s'utilise sans commutateur. Il est généralement utilisé pour boucler sur un ensemble de noms de fichier, d'autant qu'il est utilisé avec les expressions du type *.''extenstion'' ou utilisant les caractères génériques '*' et '?' autrement. Il peut être utilisé avec de simples chaînes de caractères, mais ceci est déconseillé à cause de l'interprétation de certains caractères.

 

FOR %%i IN (chaine1 chaine2) do @ECHO %%i

Cet exemple est équivalent à l'éxécution des commandes suivantes :

@ECHO chaine2

 

FOR %%i IN (fichier1.txt fichier2.txt) do @TYPE %%i

Cet exemple est équivalent à l'éxécution des commandes suivantes:

@TYPE fichier2.txt

 

FOR %%i IN (*.txt) do @TYPE "%%i"

En supposant que le répertoire courant contienne les fichiers fich1.txt, fich2.txt et fich3.txt, cet exemple est équivalent à l'éxécution des commandes suivantes :

@TYPE "install.log"

 

Ces boucles s'utilisent pour exécuter une commande plusieurs fois, au lieu de faire beaucoup de copies de la commande, la boucle FOR permet de n'écrire cette commande qu'une fois. ceci est surtout utile si le nombre de répétition est grand.

Le commutateur /L permet de faire une boucle FOR classique, c'est-à-dire qu'elle permet de boucler sur des commandes un certain nombre de fois.

FOR /L %''variable'' IN (''index de début'', ''pas'', ''index de fin'') DO ''commande''

La première boucle mettra dans ''variable'' la valeur ''index de début'', puis, à chaque boucle, la valeur affectée à ''variable'' sera incrémentée de la valeur ''pas''. Enfin, lorsque que la valeur affectée à ''variable'' dépasse la valeur ''index de fin'', la boucle s'arrête.

 

FOR /L %%i IN (1,2,10) DO @ECHO Message %%i

Ici, la variable %%i commence à 1, augmentera de 2 à chaque boucle. La boucle se terminera lorsque %%i vaudra plus de 10 (c'est-à-dire que %%i = 9 sera la dernière boucle). Cet exemple est donc équivalent à l'éxécution des commandes suivantes :

@ECHO Message 9

 

Le principe est le même que pour les boucles sur des fichiers, mais s'applique sur les répertoires lorsque que l'ensemble est une chaine contenant des caractères génériques.

Le commutateur /D permet de rechercher des répertoires au lieu de fichiers.

FOR /D %''variable'' IN (''ensemble de répertoires'') DO ''commande''

 

FOR /D %%i IN (repertoire1 repertoire2) do ECHO %%i

Cet exemple est équivalent à l'exécution des commandes suivantes :

En effet, ici, aucune interprétation d'expression n'est effectuée, c'est comme si la boucle s'effectuait sur des fichiers ou des chaînes de caractères.

 

FOR /D %%i IN (Doc*) do DIR "%%i"

Si le répertoire courant contient les répertoires ''Documents and Settings'' et ''Docs'', cet exemple est équivalent à l'exécution des commandes suivantes :

DIR "Docs"

 

Le principe est le même que les boucles sur des répertoires ou fichiers, mais les recherches se poursuivent dans les sous-répertoires lorques l'ensemble contient des caractères génériques.

L'ajout du commutateur /R permet de faire cette boucle récursive sur les sous-répertoires.

FOR /R ''[''/D'']'' %''variable'' IN (''ensemble de répertoires'') DO ''commande''

Si les commutateur /R et /D sont présents, la recherche récursive s'effectuera sur des noms de répertoires.

Comme dans le paragraphe précédent, sans caractère générique le commutateur /R est inutile.

 

FOR /R %%i IN (Doc*) do DIR "%%i"

Si le répertoire courant contient les répertoires ''Documents and Settings'' et ''Docs'', ainsi que ''temp'' contenant le sous-répertoire ''Documentation'', alors cet exemple est équivalent à l'exécution des commandes suivantes :

DIR "C:\temp\Documentation"

 

FOR /R %%i IN (Doc*) do ECHO "%%i"

équivalent possible à l'exécution des commandes suivantes:

''...''

 

Ces boucles s'utilisent pour appliquer une commande à plusieurs lignes d'un fichier. Contrairement aux autres boucles FOR qui se contentent de noms de fichiers, ces boucles ouvrent tous les fichiers indiqués, et les lisent ligne par ligne. A chaque itération de boucle correspond une ligne d'un fichier.

Le commutateur /F permet d'effectuer une boucle sur le contenu de fichiers.

FOR /F ''[''"''options''"'']'' %''variable'' IN (''ensemble de fichiers'') DO ''commande''

Il faut bien garder à l'esprit que toutes les options définies ci-après se feront sur une ligne donnée d'un fichier, et sont cumulatives.

 

Pour un découpage poussé, il faut indiquer le ou les caractères qui délimitent les zones. Par exemple, pour les mots, ce seront les caractères espace, mais on peut également découper selon plusieurs caractères différents.

"delims=''ensemble de caractères''"

Par défaut, les caractères espace et tabulation servent de séparateur.

 

Pour découper et ne pas prendre en compte tout ce qui se situe à droite d'un caractère, il existe l'option suivante (''end of line'') :

"eol=''caractère''"

"eol=#"

 

Certains fichiers peuvent contenir des entêtes inexploitables. Il est possible de les supprimer en indiquant le nombre de lignes à exclure lors de la lecture ligne par ligne du fichier. Cette option est globale au fichier, ce n'est pas un traitement de ligne.

"skip=''nombre de lignes''"

"skip=4"

 

La commande FOR ne prend qu'un seul nom de variable. Or, pour chaque ligne, il est possible de faire un découpage, mais un système est mis en place pour permettre de remplir plusieurs variables. Pour l'utiliser, il faut remplir l'option suivante:

"tokens=''chiffres séparés par virgules''''[''*'']''"

Dans la commande, pour utiliser ces différentes zones, il faut utiliser le nom de la variable avec un seul caractère, et de nouvelles variables seront automatiquement créées avec les zones suivantes en incrémentant alphabétiquement le nom de la précédente. Par exemple, si la commande FOR est déclarée avec la variable %%i, la première zone sera mémorisée dans %%i, la deuxième dans %%j, la troisième dans %%k (et ainsi de suite si d'autres zones sont définies). Utiliser la commande FOR en passant le nom de variable %%a permet d'avoir une marge généralement suffisante (26 caractères).

 

Soit un fichier ''monFich.txt'' contient les deux lignes suivantes:

sfqsdf1, zarzera2, xvwcvw3, vcnvbn4, rtyutr5, fdgh6

@ECHO zaerera2 zrezw3 veeenvbn4

 

FOR /F "usebackq delims==" %i IN (`set`) DO @echo %i

Cet exemple énumére les noms de variables d'environnement de l'environnement en cours.

 

On pourrait lire de la même façon les lignes de retour d'une commande en redirigeant la sortie d'affichage sur un fichier via l'opérateur <tt>''commande'' > ''fichier'' </tt>, mais la commande FOR permet de lire directement le retour d'une commande sans passer par un fichier.

Le principe est le même que les boucles sur les contenus de fichiers, y compris pour les options, seul l'ensemble donné change.

 

FOR /R %%i IN (` ''commande'' `) do ''commande''

A la place de l'ensemble de fichiers, il suffit de mettre une commande entre quotes inversées. Les opérations s'effectueront alors sur les lignes du retour d'affichage (qui n'est donc plus affiché).

 

L'exemple suivant permet de rechercher tous les fichiers .txt et compte le nombre de fichiers trouvés. Pour cela, la commande <tt>DIR /B *.txt</tt> liste tous les fichiers .txt sans information supplémentaire. Ainsi, il suffit de compter le nombre de lignes normalement affichées en utilisant un simple compteur.

@ECHO off

)

 

Dans tous les exemples précédents, une seule commande était exécutée, mais la commande FOR offre la possibilité d'exécuter, pour chaque itération, une succession d'instructions écrite sur plusieurs lignes via des parenthèses.

Ceci fonctionne pour tous les cas précédemment définis.

 

FOR ''commutateurs, options et variable'' IN (''ensemble'') DO (

''Commande''

La parenthèse ouvrante doit se situer sur la même ligne que le FOR pour être valide.

 

L'exemple suivant permet de rechercher tous les fichiers .txt contenant la chaîne de caractères <tt>toto</tt>. La commande <tt>FIND /C "toto" *.txt</tt> est utilisée pour faire la recherche. Cette commande retourne:

--------- ''nom du fichier lu'': ''nombre d'occurences trouvées''