Definir
Définit une ou des variables pour le résultat de l'expression ou des expressions définies jusqu'à la fin du calcul ou jusqu'à ce que le script ou le fichier soit fermé.
Format
Definir ( {[} Var1 = Expression1 {; Var2 = Expression2...]} ; Calcul )
Paramètres
Var : nom de variable (consultez la section Utilisation de variables).
Expression : une expression de calcul, une rubrique ou une constante.
Calcul : une expression de calcul, une rubrique ou une constante
Les paramètres situés entre deux accolades { } sont facultatifs.
Résultat
Texte, nombre, date, heure, horodatage, conteneur
Provient de la version
7.0
Description
La fonction Definir vous permet d'affecter les résultats des expressions aux variables et de renvoyer un résultat qui peut utiliser ces variables. Utilisez la fonction Definir pour simplifier la lecture des formules complexes et limiter l'utilisation de fonctions imbriquées dans d'autres fonctions. La fonction Definir permet également d'optimiser les formules en stockant le résultat des appels de fonctions dans des variables afin de les réutiliser dans la formule, réduisant ainsi le nombre d'appels de fonctions redondants.
Pour affecter plusieurs variables à une fonction Definir, utilisez une syntaxe sous forme de liste entre crochets [ ], séparée par des points-virgules. Pour faciliter la lecture de plusieurs variables, vous pouvez placer chaque variable et le calcul renvoyé sur des lignes séparées, bien que cette mise en forme ne soit pas obligatoire. Par exemple :
Definir ( [
variable = valeur;
variable2 = valeur2
];
calcul )La fonction Definir définit les variables de gauche à droite. Vous pouvez utiliser des variables précédemment définies (par exemple, des variables de fonction définies antérieurement dans la fonction Definir, ou des variables locales et globales que vous avez définies à l'aide de l'Définir variable action de script) pour définir de nouvelles valeurs de variable.
Vous pouvez également imbriquer plusieurs fonctions Definir les unes dans les autres. Si vous utilisez une variable de fonction précédemment définie avec une fonction Definir imbriquée, la variable de fonction intervient uniquement au sein de la fonction imbriquée (comme si vous aviez défini une variable complètement unique). Consultez l'exemple 2 ci-dessous.
Une fois définies, les variables peuvent être référencées dans n'importe quel calcul sur lequel elles peuvent porter. Les variables locales définies dans un calcul portent sur le fichier, mais sont uniquement disponibles lorsque des scripts ne sont pas en cours d'exécution. Consultez la section Utilisation de variables.
Exemple 1
Definir ( x = 5; x*x ) renvoie 25.
Definir ( [ x = 5; au carré = x*x; au cube = au carré*x]; au cube ) renvoie 125.
Exemple 2
Cet exemple renvoie San Francisco - Paris.
Definir (
Ville = "Paris";
Definir (
Ville = "San Francisco";
Ville & " - "
)
& Ville )Exemple 3
Cet exemple définit une variable locale sur le jeu de privilèges de l'accès du compte actif et renvoie le contenu de la variable. Si ce calcul est utilisé dans un script, la variable locale sera disponible pendant la durée du script.
Definir ( $PRIVILEGE_SET = Obtenir ( NomPrivilègesCompte ) ; $PRIVILEGE_SET ) renvoie [Full Access] si ce calcul est évalué pour un compte disposant du jeu de privilèges d'accès Accès intégral.
Exemple 4
Cet exemple définit le compteur d'une variable locale pour la répétition 50 sur une valeur de 120:
Definir ( $Nombre[50] = 120; $Nombre[50]*2 ) renvoie la valeur 240.
Exemple 5
Cet exemple indique comment transférer des paramètres désignés à l'aide des fonctions Evaluation, Definir et Obtenir ( ParamètreScript ), en autorisant uniquement l'accès à la variable "a" (l'exemple renvoie 6) :
ParamètreScript = "a = 5; b = 10"
Evaluer (
"Definir ( ["
& Obtenir ( ParamètreScript ) & "
];
a+1 )"
)Exemple 6
Cet exemple vous montre comment transférer des paramètres désignés, en autorisant l'accès aux variables "a" et "b". Le premier paramètre simplifié rend le second paramètre plus complexe (l'exemple renvoie 6, 12) :
ParamètreScript = "a = 5; b = 10"
Evaluer (
"Definir ( ["
& Obtenir ( ParamètreScript ) & "
];
a+1 & \", \" & b+2 )"
)Exemple 7
Cet exemple montre comment transférer des paramètres définis, tout en conservant la possibilité de vérifier la syntaxe du deuxième paramètre de la fonction Definir (l'exemple renvoie 6, 12) :
ParamètreScript = "a = 5; b = 10"
Definir ( [
a = Evaluer (
"Definir ( ["
& Obtenir ( ParamètreScript ) & "
];
a )"
),
b = Evaluer (
"Definir ( ["
& Obtenir ( ParamètreScript ) & "
];
b )"
)
];
a+1 & ", " & b+2 )