SUB

La fonction de script SUB renvoie la différence entre deux valeurs sous forme de chaîne alphanumérique à 16 caractères commençant par des zéros. La fonction SUB est l'une des nombreuses fonctions arithmétiques qui vous permettent d'effectuer des calculs dans vos scripts.

Syntaxe

SUB (Operand1, Operand2)

Paramètres

• SUB
  Soustrait Operand2 de Operand1
  Code retour : résultat de la soustraction
• Operand1
  Première expression
  Format : littéral de script, variable de script ou nombre sans guillemets
• Operand2
  Deuxième expression
  Format : littéral de script, variable de script ou nombre sans guillemets

Remarques :

• Assurez-vous que les valeurs sont comprises dans la plage autorisée pour les types de données déclarés de vos variables de scripts. C'est le type de données du résultat qui est décisif, pas celui de l'opérande. Certains types de données ne prennent pas en charge les valeurs négatives, ni les décimales. Les valeurs négatives provoquent une erreur si la variable n'est pas de type flottant. Si le type de données de la variable n'autorise pas les décimales, les décimales de votre résultat sont tronquées. Pour plus d'informations, voir Types de données des variable de script.
• Les résultats sont renvoyés au format 16 chiffres par défaut, avec des zéros au début. Les nombres flottants incluent également des emplacements à 16 décimales. Si les nombres négatifs sont pris en charge, le premier caractère est un signe d'algèbre (+ ou -).

Conseil : Vous pouvez supprimer les zéros du début ou modifier le format des résultats, via la fonction de script FORMAT.

Exemples

L'exemple ci-dessous stocke le résultat d'une soustraction dans une variable script. Opérande1 et Opérande2 sont spécifiés en tant qu'expressions numériques.

:SET &RESULT# = SUB(1000,999)

L'exemple ci-dessous montre une soustraction avec des nombres à virgule flottante : 

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

Le résultat s'affiche dans le rapport d'activation.

U0020408 +0000000000000015.7600000000000000

L'exemple ci-dessous montre une autre façon de soustraire des valeurs, en utilisant une expression arithmétique et en stockant le résultat dans une variable script.

:SET &SUBTRACT# = 3 - 2
:P &SUBTRACT#

Le résultat s'affiche dans le rapport d'activation.

U0020408 0000000000000001

Voir aussi :