Exemples de substitution

Les macros de substitution de champ peuvent être utilisées de deux manières :

• Substitution directe ou
• Substitution conditionnelle
  

Substitution directe

Ce formulaire remplace directement la valeur correspondante de l'élément concerné dans la sortie.

Structure : %<macroName>%

Où <macroName> peut être l’une des macros répertoriées dans les tableaux Macros de substitution de champ.

Exemples

• %Nom de classe%
• %opName%
• %attName%
  

Substitution conditionnelle

Cette forme de macro permet de réaliser des substitutions alternatives en fonction de la valeur de la macro.

Structure : %<macroName> (== "<texte> " ) ? <subTrue> (: <subFalse>) %

Où:

• () indique que les valeurs entre parenthèses sont facultatives
• <text> est une string représentant une valeur possible pour la macro
• <subTrue> et <subFalse> peuvent être une combinaison de chaînes entre guillemets et du mot-clé valeur ; lorsque la valeur est utilisée, elle est remplacée par la valeur de la macro dans la sortie

Exemples

• %classAbstract=="T" ? "pure" : " "%
• %opStereotype=="opérateur" ? "opérateur" : " "%
• %paramDefault != " " ? " = " valeur : " "%

Ces trois exemples ne génèrent aucun résultat si la condition échoue. Dans ce cas, la condition False peut être omise, ce qui donne cette utilisation :

• %classAbstract=="T" ? "pur"%
• %opStereotype=="opérateur" ? "opérateur"%
• %paramDefault != " " ? " = "valeur%

Le troisième exemple des deux blocs montre une comparaison vérifiant une valeur non vide ou une existence. Ce test peut également être omis.

• %paramDefault ? " = " valeur : " "%
• %paramDefault ? " = " valeur%

Tous ces exemples contenant paramDefault sont équivalents. Si le paramètre concerné avait une valeur par défaut de 10, la sortie de chacun d'eux serait normalement :

= 10

Notes

• Dans une macro de substitution conditionnelle, tout espace blanc suivant <macroName> est ignoré ; si un espace blanc est requis dans la sortie, il doit être inclus dans les chaînes de substitution entre guillemets

Apprenez Plus

• Macros de substitution de champs