====== Comment répéter une commande N fois? ======

TeX n'a //pas// été conçu comme un langage de programmation, mais il arrive de vouloir répéter
une partie d'un document, tout comme certaines parties de programmes doivent être exécutées plusieurs fois.
La conception de schémas est un exemple évident. Dans l'exemple ci-dessous, vous n'avez évidemment pas envie
de répéter manuellement le dessin de chaque graduation sur l'axe, alors que l'ordinateur saurait très bien le faire pour vous:
<latexdoc>
\documentclass{article}
  \usepackage{tikz}
  \pagestyle{empty}

\begin{document}
\begin{tikzpicture}
\draw[line width=.8pt,->] (0cm,0pt) -- ++(5.5cm,0pt) ;
\foreach \x in {0,0.5,...,5.0} \draw (\x cm,4pt) -- (\x cm,-4pt) node[anchor=north,font=\footnotesize\it] {\x} ;
\end{tikzpicture}
\end{document}
</latexdoc>
Donc tous naturellement, l'environnement ''picture'' de LaTeX et [[ctanpkg>pgf|PGF]] (notamment)
fournissent des fonctions pour répéter des actions.
Même en dehors du contexte de dessin, il est souvent plus simple d'utiliser ces fonctionnalités,
plutôt que de les réimplémenter à l'aide d'obscures macros TeXniques.

Cette réponse traite de la répétition d'une opération un nombre donné de fois;
si vous souhaitez exécuter une action pour chaque élément d'une liste d'objets
lisez plutôt la réponse à la question
«[[2_programmation:syntaxe:repeter_une_commande_pour_chaque_element_d_une_liste|Comment répéter une action pour chaque élément d'un ensemble?]]».

===== En Plain TeX =====

Plain TeX fournit lui-même une structure ''\loop''(nbsp)...(nbsp)''\repeat'', qui permet de répéter une commande
(ou un ensemble de commandes). La syntaxe est relativement simple, mais l'utilisation des structures conditionnelles de TeX
est assez inhabituelle, ce qui fait que beaucoup de personnes la trouvent déroutante. 

Voici un exemple:
<code latex>
\newcount\foo
\foo=10
\loop
  \message{\the\foo}
  \advance \foo -1
\ifnum \foo>0
\repeat
</code>

Dans ce code un peu intrigant, ''\loop'' démarre la boucle terminée par ''\repeat'',
en même temps, ''\repeat'' tient également lieu de ''\fi'' pour le ''\ifnum''.
La boucle ci-dessus imprime donc les nombres de 10 à 1 dans le terminal, en utilisant la primitive TeX ''\message''.


===== Avec l'extension “multido” =====

L'extension [[ctanpkg>multido]] est également «générique» (//ie// utilisable aussi bien avec Plain TeX que LaTeX);
elle définit une commande ''\multido'' prenant trois arguments:
<code latex>
  \multido{⟨variables⟩}{⟨répétitions⟩}{⟨choses à répéter⟩}
</code>

Lorsque la macro s'exécute, les ''⟨//choses à répéter//⟩'' sont exécutées ''⟨//répétitions//⟩'' fois;
l'argument ''⟨//variables//⟩'' donne une liste de variables qui peuvent être utilisées dans les ''⟨//choses à répéter//⟩''.
Chaque variable est composée d'une suite de commandes et de la façon dont elle varie;
ainsi, la valeur ''\iz=2+4'' définirait la variable ''\iz'' à ''2'' la première fois, puis à ''6'' et ''10''
lors des deux itérations suivantes, et ainsi de suite.
(Si le nom de la variable commence par un ''i'', comme ''\iz'', elle représente un nombre entier;
les autres lettres initiales représentent d'autres types de données).

LaTeX dans sa version actuelle, ainsi que LaTeX3 (expérimental), comportent tous deux des commandes d'itération
pour leur usage interne, utilisables par les auteurs de paquets; cependant leur utilisation dans un document LaTeX
n'est pas recommandée.


===== Avec l'extension “ifthen” =====

L'extension [[ctanpkg>ifthen]], fournie avec LaTeX, propose la macro ''\whiledo'':

<code latex>
\newcounter{ct}
...
\setcounter{ct}{1}
\whiledo {\value{ct} < 5}%
{%
  \thect\
  \stepcounter {ct}%
}
</code>

===== Avec l'extension “forloop” =====

L'extension [[ctanpkg>forloop]] propose une unique macro, ''\forloop'':

<code latex>
\newcounter{ct}
...
\forloop{ct}{1}{\value{ct} < 5}%
{%
  \thect\
}
</code>

Comme vous pouvez le voir, les arguments sont le compteur, la valeur de départ et la condition de fin;
un argument facultatif fournit une valeur d'incrément (l'incrément par défaut est de ''1'').

===== Avec l'environnement “picture” =====

L'environnement ''picture'' de LaTeX possède une commande simple pour répéter des opérations dans un dessin: 
<code latex>
\multiput(⟨x⟩,⟨y⟩)(⟨xstep⟩,⟨xstep⟩){⟨n⟩}{⟨obj⟩}
</code>
qui place ''⟨//obj//⟩'' (par exemple un élément d'une image) ''⟨//n//⟩'' fois aux positions
  * ''(⟨//x//⟩, ⟨//y//⟩)'',
  * ''(⟨//x//⟩ + ⟨//xstep//⟩, ⟨//y//⟩ + ⟨//ystep//⟩)'',
  * ''(⟨//x//⟩ + 2 ⟨//xstep//⟩, ⟨//y//⟩ + 2 ⟨//ystep//⟩)''
  * et ainsi de suite,
en ajoutant à chaque fois le déplacement ''(⟨//xstep//⟩, ⟨//ystep//⟩)''.
Cette commande a été conçue pour être utilisée dans un evironnement ''picture'',
mais elle ne fait aucun contrôle particulier pour ça,
et peut tout à fait être utilisée dans du texte ordinaire, comme ceci par exemple:
<code latex>
Et nous \multiput(0,0)(2,3){3}{re}voilà!
</code>
qui donnera, de façon prévisible mais pas forcément souhaitable:
<latex>Et nous \multiput(0,0)(2,3){3}{re}voilà!</latex>.

Elle peut être utilisé avec un simple calcul itératif dans son dernier argument,
auquel cas ses capacités graphiques n'ont aucun effet.


===== Avec l'extension “PGF” (TikZ) =====

L'extension [[ctanpkg>pgf|pgffor]], qui fait partie de [[ctanpkg>pgf|PGF]], fournit également de quoi faire des itérations
pour répondre aux besoins des graphiques.
Sa syntaxe reprend le style des langages de programmation courants:

<WRAP column 50ex>
<code latex>
\documentclass{article}
  \usepackage{pgffor}

\newcommand{\cmd}{-x-}

\begin{document}
  \foreach \n in {1,...,4}{\cmd{}}
\end{document}
</code>
</WRAP>
<WRAP column 30ex>
<latexdoc>
\documentclass{article}
  \usepackage{pgffor}
  \pagestyle{empty}

\newcommand{\cmd}{-x-}

\begin{document}
  \foreach \n in {1,...,4}{\cmd{}}
\end{document}
</latexdoc>
</WRAP>
<WRAP clear />

La commande ''\foreach'' présente l'inconvénient potentiel que son contenu est exécuté dans un groupe,
de sorte que tous les calculs effectués dans la boucle sont perdus (à moins que leur résultat ne soit rendu ''\global'');
cependant, elle n'a rien de particulièrement spécifique au dessin, à la différence de ''\multiput'',
de sorte que son potentiel en dehors de son environnement graphique d'origine est plus clair.

-----
//Source:// [[faquk>FAQ-repeat-num|Repeating a command ‘n’ times]]

{{htmlmetatags>metatag-keywords=(LaTeX,boucles,répéter une commande,itérations en LaTeX,répétition de commande,exécuter en boucle)
metatag-og:title=(Comment répéter une commande N fois?)
metatag-og:site_name=(FAQ LaTeX francophone)
}}