4.1.4 \DeclareTextCommand & \ProvideTextCommand

Synopsis, l’un parmi :

\DeclareTextCommand{\cmd}{codage}{défn}
\DeclareTextCommand{\cmd}{codage}[nargs]{defn}
\DeclareTextCommand{\cmd}{codage}[nargs][défautargopt]{défn}

ou l’un parmi :

\ProvideTextCommand{\cmd}{codage}{défn}
\ProvideTextCommand{\cmd}{codage}[nargs]{défn}
\ProvideTextCommand{\cmd}{codage}[nargs][défautargopt]{défn}

Définit la commande \cmd, laquelle sera spécifique à un codage. Le nom cmd de la commande doit être précédé d’une controblique, \. Ces commandes ne peuvent apparaître que dans le préambule. Redéfinir \cmd ne cause pas d’erreur. La commande définie sera robuste même si le code dans défn est fragile (voir \protect).

Par exemple, le fichier t1enc.def contient la ligne suivante :

\DeclareTextCommand{\textperthousand}{T1}{\%\char 24 }

Avec cela, vous pouvez exprimer des pour-milles comme ceci :

\usepackage[T1]{fontenc}  % dans le préambule
  ...
La limite légale est de \( 0,8 \)\textperthousand.

Si vous changez le codage de fonte en OT1 alors vous obtenez une erreur du genre de ‘LaTeX Error: Command \textperthousand unavailable in encoding OT1’.

La variante \ProvideTextCommand agit de même, à ceci près qu’elle ne fait rien si \cmd est déjà définie. La commande \DeclareTextSymbol est plus rapide pour une simple association d’un cassetin à un glyphe (voir \DeclareTextSymbol)

Les arguments optionnels nargs et défautargopt jouent le même rôle que dans \newcommand (voir \newcommand & \renewcommand). En un mot, nargs est un entier de 0 à 9 spécifiant le nombre d’arguments que la commande \cmd qu’on définit prend. Ce nombre inclut tout argument optionnel. Omettre cet argument revient au même que spécifier 0 pour dire que \cmd n’a aucun argument. Et, si défautargopt est présent, alors le premier argument de \cmd est optionnel, et sa valeur par défaut est défautargopt (ce qui peut être la chaîne vide). Si défautargopt n’est pas présent alors \cmd ne prend pas d’argument optionnel.