Manuel des Scripts Automation Engine > Organisation fonctionnelle > Arithmetics > ADD

ADD

Fonction de Script : Exécute une addition.

Syntaxe

ADD(Opérande1, Opérande2)

Elément de syntaxe	Description/format
Opérande1	Première expression de calcul. Format : littéral de Script, variable de Script ou nombre sans guillemets
Opérande2	Deuxième expression de calcul. Format : littéral de Script, nombre sans guillemets ou Variable de Script

Code retour
Résultat de l'addition

Remarques

La fonction de Script additionne Opérande1 et Opérande2.

Opérande1 et Opérande2 doivent être des expressions qui correspondent aux nombres dans le domaine de valeur des Types de données. Le résultat ne doit en aucun cas dépasser ce domaine.

Si le résultat d'une Variable de Script est affecté, celle-ci doit présenter le type de données correspondant. Lors d'une tentative d'enregistrement d'un nombre négatif comportant le type de données "unsigned" dans une Variable, une erreur apparaît. S'il s'agit, lors du résultat, d'un nombre à virgule flottante et si la Variable de destination possède le type de données "signed" ou "unsigned", les chiffres après la virgule sont supprimés. Le type de données "flottant" prend en charge tant les nombres négatifs que les nombres variables. De plus, le type de données "chaîne" est également possible tant que le résultat n'est pas stocké comme un nombre mais comme une chaîne de caractères. Le type de données des Variables de Script est défini avec le Script :DEFINE.

Le système compte toujours le type de données du résultat, et non celui des opérandes ! Un opérande négatif ou positif peut produire un nombre positif qui peut à son tour être enregistré dans une Variable de destination avec le type de données "unsigned".

Attention : lors d'opérations de calcul avec des nombres variables, le résultat peut être imprécis !

Le résultat est retourné dans le format par défaut à 16 caractères. Les nombres variables possèdent 16 caractères supplémentaires après la virgule et lorsque des nombres négatifs sont pris en charge, le signe respectif (+ ou -) est placé en première position. Pour modifier le formatage, utilisez la fonction script FORMAT.

Exemples

Dans l'exemple, le résultat de l'opération arithmétique est transmis à une Variable de Script. Opérande1 et Opérande2 sont indiqués dans une expression numérique.

:SET &RESULTAT# = ADD(1000,333)

Dans cet exemple, la fonction est utilisée pour formuler une condition.

:SET &MAXIMUM# = 3000
:SET &EXEC1# = 5000
:SET &EXEC2# = 2000
!...
:IF ADD(&EXEC1#,&EXEC2#) > &MAXIMUM#
!...
:ENDIF

Deux nombres variables sont ajoutés dans les exemples suivants.

:DEFINE &RESULTAT#,float
:SET &RESULTAT# = ADD(10.31,-5.45)
:P &RESULTAT#

Le résultat s'affiche dans le protocole d'activation de la façon suivante .

U0020408 +0000000000000004.8600000000000000

Rubriques connexes :

Script	Description
SUB	Exécute une soustraction.
MULT	Exécute une multiplication.
DIV	Exécute une division.
MOD	Indique le quotient d'une division.
RANDOM	Génère des nombres aléatoires.

Scripts - Calculs

Généralités sur les Scripts
Script - Liste alphabétique
Script - Division fonctionnelle