***_TO_STRING : conversion d'une variable en une chaîne de caractères

Description de la fonction

La fonction ***_TO_STRING permet de convertir une variable ou en une chaîne de caractères.

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

Fonctions disponibles

Les fonctions disponibles sont les suivantes :

INT_TO_STRING
DINT_TO_STRING
REAL_TO_STRING.

Représentation en FBD

Représentation appliquée à une variable REAL :

Représentation en LD

Représentation appliquée à une variable REAL :

Représentation en IL

Représentation appliquée à une variable REAL :

LD Value1

REAL_TO_STRING

ST Result_Str

Représentation en ST

Représentation appliquée à une variable REAL :

Result_Str:= REAL_TO_STRING(Value1);

Description des paramètres

Le tableau suivant décrit les paramètres d’entrée :

Paramètre	Type	Commentaire
Value1	INT, DINT, REAL	Variable à convertir en chaîne de caractères.

Le tableau suivant décrit les paramètres de sortie :

Paramètre	Type	Commentaire
Result_Str	STRING	Result_Str est une chaîne de caractères dont la longueur dépend du type du paramètre Value1 : 5 chiffres plus le signe, ce qui donne 6 caractères pour le type INT (exemple : '-00045'), 10 chiffres plus le signe, ce qui donne 11 caractères pour le type DINT (exemple : '-0000678911'), Remarque : dans PL7, le résultat est de 11 chiffres plus le signe, ce qui donne 12 caractères, pour le type DINT (exemple : '-00006789110'). 14 caractères pour le type REAL (exemple : ‘-3.1234560e+25’).

Erreurs d'exécution

Si, durant la conversion d'une valeur de type REAL, le paramètre Value1 n'est pas compris entre -3.402824e+38 et -1.175494e-38 ou entre +1.175494e-38 et +3.402824e+38, le bit %S18 est défini sur 1 et le contenu de la chaîne Result_Str n'est pas significatif.

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.

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.