SUB : soustraction

Description du fonctionnement

La fonction soustrait la valeur de l’entrée Value2 de celle de l’entrée Value1 et délivre le résultat en sortie.

Les types de données des valeurs d’entrée et celui de la valeur de sortie doivent être identiques.

Le module SUB_TIME est disponible pour la soustraction avec des valeurs du type de données .

Les paramètres supplémentaires et peuvent être configurés.

Formule

Difference = Value1 - Value2

Représentation dans FBD

Représentation :

Représentation dans LD

Représentation :

Représentation dans IL

Représentation :

LD Value1
SUB Value2
ST Difference

Représentation dans ST

Représentation :

Difference := SUB (Value1, Value2) ;

Description des paramètres

Description des paramètres d'entrée :

Paramètre	Type de données	Signification
Value1	INT, DINT, UINT, UDINT, REAL	Opérande
Value2	INT, DINT, UINT, UDINT, REAL	Opérande

Description des paramètres de sortie :

Paramètre	Type de données	Signification
Difference	INT, DINT, UINT, UDINT, REAL	Différence

Erreur d’exécution

Le bit système %S18 est configuré sur 1 si

la plage des valeurs est dépassée en sortie (tous les types de données disponibles)

ou

un paramètre d’entrée du type de données REAL est assorti d’un nombre en virgule flottante non admis. De plus, dans ce cas, le statut devient %SW17.

TIME

Le type TIME exprime une durée en millisecondes. Codé sur 32 bits, ce type permet d'obtenir des durées de 0 à 2 32-1 millisecondes.

Le type TIME présente les unités suivantes : jours (d), heures (h), minutes (m), secondes (s) et millisecondes (ms). Une valeur littérale de type TIME est représentée par une combinaison des types précédents associés au préfixe T#, t#, TIME# ou time#.

Exemples : T#25h15m, t#14,7S, TIME#5d10h23m45s3ms

EN correspond à ENable (activer) ; il s'agit d'une entrée de bloc facultative. Quand l'entrée EN est activée, une sortie ENO est automatiquement définie.

Si EN = 0, le bloc n'est pas activé, son programme interne n'est pas exécuté et ENO est réglé sur 0.

Si EN = 1, le programme interne du bloc est exécuté et ENO est réglé sur 1. Si une erreur survient, ENO reprend la valeur 0.

Si l'entrée EN n'est pas connectée, elle est automatiquement réglée sur 1.

ENO

ENO signifie Error NOtification (notification d'erreur). C'est la sortie associée à l'entrée facultative EN.

Si ENO est réglé sur 0 (car EN = 0 ou en cas d'erreur d'exécution) :

les sorties du bloc fonction restent dans l'état qui était le leur lors du dernier cycle de scrutation exécuté correctement ;
la ou les sorties de la fonction, ainsi que les procédures, sont réglées sur 0.

REAL

Le type REAL (réel) est codé sur 32 bits.

Les plages de valeurs possibles sont indiquées dans la figure suivante :

Lorsqu'un résultat est :

compris entre -1,175494e-38 et 1,175494e-38, il est considéré comme étant un DEN ;
inférieur à -3,402824e+38, le symbole -INF (pour - infini) s'affiche ;
supérieur à +3,402824e+38, le symbole INF (pour + infini) s'affiche ;
indéfini (racine carrée d'un nombre négatif), le symbole NAN s'affiche.

NOTE : La norme CEI 559 définit deux catégories de NAN : le NAN silencieux (QNAN) et le NAN de signalement (SNAN). Un QNAN est un NAN (Not a Number) avec un bit de fraction de poids fort tandis qu'un SNAN est un NAN sans bit de fraction de poids fort (bit numéro 22). Les QNAN peuvent être propagés par la plupart des opérations arithmétiques, sans générer d'exception. Quant aux SNAN, ils signalent en général une opération non valide lorsqu'ils sont utilisés en tant qu'opérandes dans des opérations arithmétiques (voir %SW17 et %S18).

NOTE : Lorsqu'un DEN (nombre non normalisé) est utilisé en tant qu'opérande, le résultat n'est pas significatif.