Guide de référence des variables du langage de génération par template

Les variables sont des valeurs qualifiées encadrées de signes % et éventuellement précédées d'option de format. Au moment de l'évaluation, elles sont remplacées par leur valeur correspondance dans la portée de conversion active.

Une variable peut avoir le type suivant :

Par exemple, la variable %Name% d'une interface peut être directement évaluée par une macro et remplacée par le nom de l'interface dans le fichier généré.

%[.formatting-options:]variable%

[outer-scope.][variable-object.][object-scope.]object-member
[outer-scope.][variable-object.][collection-scope.]collection-member
[outer-scope.]local-variable
[outer-scope.]global-variable

volatile-attribute
property
[target-code::]extended-attribute
[target-code::][metaclass-name::]template-name[(parameter-list)]
[*]+local-value[(parameter-list)]

objecttype-property
oid-valued-object-member
this

First
IsEmpty
Count

First

local-object
[*]local-value

global-object
global-value
$environment variable

global-object
local-object

[outer-scope.]Outer

[object-scope.]object-member-object
collection-scope.collection-member-object

[object-scope.]collection
[object-scope.]semi-colon-terminated-oid-valued object-member

• Membres d'objet
  Un membre d'objet peut être un attribut volatile, une propriété standard, un template ou un attribut étendu. Il peut y avoir trois types de propriété standard : boolean, string ou object. La valeur d'une propriété standard peut être :
• Membres de collection
  Chaque objet peut avoir une ou plusieurs collections qui contiennent les objets avec lesquels ils interagissent. Par exemple, une table a des collections de colonnes, d'index, de règles de gestion, etc.
• Blocs conditionnels
  Les blocs conditionnels peuvent être utilisés pour spécifier différents templates en fonction de la valeur d'une variable. Il existe deux types de bloc conditionnels différents :
• Variables globales
  Les variables globales sont disponibles quelle que soit la portée courante. Certaines variables spécifiques au langage de génération par template sont répertoriées dans le tableau suivant :
• Variables locales
  Vous pouvez définir des variables locales à l'aide des macros .set_object et .set_value
• Options de formatage des variables
  Vous pouvez incorporer des options de format dans la syntaxe d'une variable comme suit :
• Opérateurs du langage de génération par template
  Le langage de génération par template prend en charge des opérateurs arithmétiques standard ainsi que certains opérateurs de template avancés.
• Portée de la conversion
  La portée de la conversion définit le contexte d'évaluation d'un template, en déterminant l'objet auquel le template est appliqué. La portée peut changer lors de la conversion d'un template, mais un seul objet peut être actif à la fois.
• Héritage et polymorphisme
  Les templates sont définis par rapport à une métaclasse donnée et sont hérités par et disponibles pour les enfants de cette métaclasse. Dans l'exemple suivant, le template de définition spécifié sur la métaclasse parent est utilisé dans l'évaluation du template de contenu sur la métaclasse enfant.
• Conversion d'un raccourci
  Les raccourcis sont déréférencés lors de la conversion : la portée de l'objet cible remplace la portée du raccourci.
• Séquences d'échappement
  Des séquences d'échappement sont des séquences de caractères spécifiques utilisées pour configurer la présentation du fichier généré.
• Partage de templates
  Dans le mécanisme du langage de génération par template, vous pouvez partager des conditions, des templates et des sous-templates afin de faciliter la maintenance du langage et le rendre plus lisible.
• Utilisation de nouvelles lignes dans la chaîne d'en-tête et de fin
  Les chaînes d'en-tête et de fin sont utiles car elles ne sont générées que lorsque nécessaire, cela est particulièrement utile lorsque vous utilisez de nouvelles lignes '\n'. Elles sont ajoutées respectivement au début et à la fin du code généré, la chaîne d'en-tête et la chaîne de fin n'apparaissant pas dans le code généré.
• Utilisation du passage de paramètres
  Vous pouvez passer des paramètres dans, hors ou dans/hors un template via des variables locales en tirant parti des portées de traduction. Vous pouvez accéder à des paramètres avec la variable %@<number>%.
• Messages d'erreur
  Les messages d'erreur interrompent la génération du fichier dans lequel des erreurs ont été trouvées. Ces erreurs sont affichées dans l'onglet Aperçu de la feuille de propriétés de l'objet correspondant.