|
:DATA |
Elaboration et traitement des Scripts |
:EXT_REPORT_OFF |
|
| Instruction de script : Déclaration d'une Variable de script avec un type spécifique de données. |
:D[EFINE] nom de Variable, type de données [, taille du tableau]
|
Elément de syntaxe |
Description/format |
|---|---|
|
Nom de Variable |
Nom de la Variable de script qui est de nouveau créée en indiquant le type de données. |
|
Type de données |
Type de données de la Variable déclarée. Valeurs autorisées : "unsigned", "string", "float" ou "signed" unsigned : nombres entiers positifs sans signes L'indication des types de données s'effectue sans guillemet ! |
| Taille du tableau |
Si la Variable de script doit être créée sous forme de tableau, la taille est définie via ce paramètre. Valeurs autorisées : |
Il est possible de créer des Variables de script directement avec le script :SET. L'attribution de la valeur s'effectue alors simultanément. Ceci est cependant uniquement autorisé si les valeurs indiquées correspondent aux types de données "string" ou "unsigned" ! Si la Variable est affectée à un nombre à virgule flottante ou à un nombre négatif, une erreur de script apparaît.
Toute déclaration de Variables qui ont déjà été utilisées est impossible ! Ceci est applicable pour les Variables d'objets et script, y compris les définitions dans l'onglet "Variables & Prompts" !
L'attribution directe de la valeur d'un autre type de données fonctionne uniquement pour les Variables de script qui ont été créées avec :SET et uniquement avec des nombres entiers positifs et des chaînes !
Il est impossible d'attribuer une valeur à une Variable de script déclarée qui ne se trouve pas dans la plage autorisée du type de données défini !
Si lors de l'utilisation du script :DEFINE, aucun type de données ou un type de données non valide est indiqué, une erreur de script apparaît.
Les différents types de données possèdent les plages de valeurs suivantes :
| Type de données | Plage de valeurs |
|---|---|
| unsigned | 0 à +9 999 999 999 999 999 |
| signed | -9 999 999 999 999 999 à +9 999 999 999 999 999 |
| string | de 1 à 1 024 caractères |
| flottant | -9999999999999999.9999999999999999 à +9999999999999999.9999999999999999 |
L'indication du paramètre Taille du tableau permet de créer la Variable de script sous forme de tableau avec la longueur définie. La taille ne doit alors pas dépasser la valeur 99 999. Attention aux spécificités d'utilisation des Tableaux de script. Les crochets [] ne sont pas nécessaires dans la déclaration du tableau.
Utilisez l'instruction de script :FILL pour remplir les tableaux de script avec plusieurs valeurs différentes.
Déclaration de plusieurs Variables avec différents types de données et attribution de valeur consécutive :
:DEFINE &a#, unsigned
:DEFINE &b#, signed
:DEFINE &c#, float
:DEFINE &d#, string
:SET &a# = 12
:SET &b# = -5
:SET &c# = 0.50
:SET &d# = "string"
L'attribution suivante génère une erreur, car les types de données ne correspondent pas :
:DEFINE &unsigned#, unsigned
:DEFINE &string#, signed
:SET &unsigned# = 12
:SET &string# = &unsigned#
Dans l'exemple suivant, l'attribution est valable, car la Variable "&unsigned#" avec la fonction script CONVERT est convertie dans le type de données approprié :
:DEFINE &unsigned#, unsigned
:DEFINE &string#, signed
:SET &unsigned# = 12
:SET &string# = CONVERT(string,&unsigned#)
Si une Variable de script est créée avec le script :SET, une attribution directe de la valeur des types de données "unsigned" et "string" est possible.
:SET &setvar# = 12
:SET &setvar2# = "string"
:SET &setvar# = &setvar2#
Le dernier exemple montre la création et le remplissage d'un tableau avec les valeurs à partir d'un objet Variable.
:DEFINE &array#, unsigned, 5
:FILL &array#[] = GET_VAR(VARA1, ARRAY)
Rubriques connexes :
| Elément de script | Description |
|---|---|
|
Attribue une valeur à une Variable de script. |
Scripts - Elaboration et traitement des scripts
Généralités sur les scripts
Elément de script - Liste alphabétique
Elément de script - Division fonctionnelle