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

SUB

Fonction de Script : Exécute une soustraction.

Syntaxe

SUB(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 la soustraction

Remarques

La fonction de Script soustrait Opérande1 de 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.

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 dans la définition avec le Script :DEFINE.

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

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

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.

Exemple

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# = SUB(1000,999)

L'exemple suivant montre une soustraction avec des nombres variables.

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

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

U0020408 +0000000000000015.7600000000000000

 

Rubriques connexes : 

Script Description
ADD Exécute une addition.
MULT Exécute une multiplication.
MOD Indique le quotient d'une division.
DIV Exécute 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