Comment gérer des compteurs?

Un certain nombre de compteurs sont prédéfinis en . Par exemple, les compteurs de page, de chapitre, de section, de note de bas de page…

Pour utiliser un nouveau compteur, il faut avant tout le déclarer. Cela se fait par l'intermédiaire de la commande suivante :

\newcounter{nom}[nom-maître]

L'argument obligatoire contient le nom du nouveau compteur (qui est un nom ne commençant pas par une contre-oblique), et l'argument optionnel est le nom d'un compteur « maître » qui, lorsqu'il est modifié, remet à zéro le compteur nouvellement défini (voir la question « Comment définir un compteur dépendant d'un autre compteur ? »).

La définition d'un compteur s'accompagne de la création d'une commande nommée \thecompteur, dont le rôle est d'afficher la valeur du compteur dénommé compteur (cette commande peut cependant être redéfinie comme indiquée plus bas mais il vaut mieux ici consulter la question « Comment redéfinir les commandes de compteur \the(...) ? »).

Par défaut, la valeur initiale d'un compteur est 0.

Pour incrémenter cette valeur, on peut utiliser une des deux commandes suivantes :

\stepcounter{compteur}
\refstepcounter{compteur}

La différence est que, dans le deuxième cas, le compteur incrémenté sert de compteur « de référence » pour la prochaine commande \label. Cette dernière prend toujours la valeur du dernier compteur qui a été incrémenté par la commande \refstepcounter.

Une commande permet d'augmenter un compteur d'un certaine valeur (un entier positif ou négatif) :

\addtocounter{compteur}{valeur} 

Une autre commande lui donne une valeur (entière) particulière :

\setcounter{compteur}{valeur}

Pour récupérer la valeur d'un compteur, outre la commande \thecompteur, on peut utiliser les commandes arabic, roman, Roman, alph et Alph, qui affichent la valeur du compteur respectivement en chiffres arabes, romains minuscules, romains majuscules, en la lettre de l'alphabet minuscule correspondante et en la lettre de l'alphabet majuscule correspondante. Ces commandes permettent de redéfinir la commande \thecompteur :

\newcounter{section}[chapter]
\renewcommand{\thesection}%
             {\thechapter.\roman{section}}