Définition des variables

Chapter 9 Guide de référence de la génération (GTL)

Définition des variables

Les variables sont des valeurs qualifiées encadrées par des caractères % et éventuellement précédés par des options de format. Au moment de l'évaluation, elles sont remplacées par la valeur correspondante dans la portée de la traduction courante.

Une variable peut avoir l'un des types suivants :

Attribut d'un objet
Membre d'une collection ou d'une collection étendue
Template
Variable d'environnement

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

Respect de la casse
Attention, la casse des caractères est prise en compte pour les noms de variable. La première lettre d'un nom de variable doit être une majuscule, comme dans %Code%.

Syntaxe des variables

Les variables suivantes sont représentées avec leur syntaxe possible :

Variable	Syntaxe
bloc-variable	'%' ['.' <options-format> ':'] <variable> '%'
variable	[<portée-externe> '.'] [<objet-variable> '.'] [<portée-objet> '.'] <membre-objet> [<portée-externe> '.'] [<objet-variable> '.'] [<portée-collection> '.'] <membre-collection> [<portée-externe> '.'] <variable-locale> [<portée-externe> '.'] <variable-locale>
membre-objet	<attribut-volatile> <propriété> [<code-cible> '::'] <attribut-étendu> [<code-cible> '::'] [<nom-métaclasse> '::']<nom-template> ['('<liste-paramètres>')'] ['*']+ <valeur-locale> ['('<liste-paramètres>')']
objet-membre-objet =	<propriété-objecttype> <membre-ayant-pour-valeur-un-OID> 'this'
membre-collection	'First' 'IsEmpty' 'Count'
collection-membre-objet =	'First'
variable-locale	<objet-local> [' * '] <valeur-locale>
variable-globale	<objet-global> <valeur-globale> '$' <variable d'environnement>
objet-variable	<objet-global> <objet-local>
portée-externe	[<portée-externe> '.'] 'Outer'
portée-objet	[<portée-objet> '.'] <objet-membre-objet> <portée-collection> '.' <collection-membre-objet>
portée-collection	[<portée-objet> '.'] <collection> [<portée-objet> '.'] <membre-ayant-pour-valeur-un-OID-terminé-par un-point-virgule>

Pour plus d'informations sur les collections étendues, reportez-vous à la section "Définition d'une collection étendue dans un profil", dans le chapitre "Gestion des profils".