Manuel des Scripts Automation Engine > Introduction > Premières étapes > Fonctions de Script

Fonctions de Script

Objectifs :
- Appeler une fonction script
- Enregistrer le code retour de la fonction dans une Variable de Script
- Afficher la Variable dans le protocole d'activation

Leçon 4

Les fonctions de Script sont des Scripts AE qui fournissent des codes retour. De nombreuses fonctions ne fournissent pas seulement des valeurs, mais exécutent également des actions. Les fonctions de Script ne doivent pas figurer en début de ligne et ne peuvent ainsi être utilisées qu'avec des instructions de Script. Elles sont surlignées en rouge dans l'éditeur de Script de l'Interface Utilisateur.
Le nom de la fonction est suivi de parenthèses qui peuvent contenir des paramètres.

 

Dans la leçon suivante, nous allons effectuer une opération de calcul à l'aide d'une fonction script.

Nous créons d'abord une Variable de Script avec le type de données "float" (voir également leçon 3).

:DEFINE &résultat#, float

Nous utilisons ensuite la fonction script DIV pour effectuer une division. La fonction comporte deux paramètres : Nombre 1 et 2.
Le nombre 1 est divisé par le nombre 2. Le code retour de la fonction est le résultat de la division. Nous enregistrons ce résultat dans une Variable de Script ; l'instruction de Script :SET est requise.

Si nous combinons maintenant l'instruction de Script :SET, la Variable de Script &résultat# et la fonction script DIV, nous obtenons la ligne suivante :

:SET &résultat# = DIV(1,4)

Nous voulons maintenant afficher le résultat dans le protocole d'activation.

:PRINT "Résultat : 1/4 = &résultat#" 

Résultat dans le rapport d'activation :

2011-04-06 14:48:17 - U0020408 Résultat : 1/4 = +0000000000000000.2500000000000000

La fonction script FORMAT vous permet par exemple maintenant de formater le résultat de la division. Dans notre exemple, nous supprimons les zéros inutiles au début et à la fin.

:SET &format# = FORMAT(&résultat#,"0.00")
:PRINT "Résultat formaté : &format#" 

Protocole d'activation :

2011-04-06 14:48:17 - U0020408 Résultat formaté : 0.25