CONCAT_STR : concaténation de deux chaînes de caractères

Description de la fonction

La fonction CONCAT_STR concatène deux chaînes de caractères.

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

Représentation en FBD

Représentation :

Représentation en LD

Représentation :

Représentation en IL

Représentation :

LD String1

CONCAT_STR String2

ST Result_String

Représentation en ST

Représentation :

Result_String := CONCAT_STR(String1, String2);

Description des paramètres

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

Paramètre	Type	Commentaire
String1	STRING	Première chaîne de caractères à concaténer. Exemple : String1 contient « SWITCH TO »
String2	STRING	Seconde chaîne de caractères à concaténer. Exemple : String2 contient « RUN »

NOTE : CONCAT_STR n'insère pas un espace vide entre les chaînes d'entrée. Pour faciliter la lecture de Result_String, il peut être nécessaire d'ajouter un espace vide à la fin de String1 ou au début de String2.

Le tableau suivant décrit le paramètre de sortie :

Paramètre	Type	Commentaire
Result_String	STRING	Chaîne résultante égale au contenu des deux chaînes String1 et String2. Exemple : pour les valeurs d’exemple du tableau précédent, Result_String contient « SWITCH TO RUN »

Erreurs d’exécution

Le bit %S15 est réglé sur 1 dans les cas suivants :

Si la chaîne Result_String est trop courte pour contenir le résultat, ce dernier est tronqué. Dans le cas contraire, la chaîne Result_String est complétée par des caractères NUL (16#00).
Si la chaîne Result_String est utilisée comme entrée sur IN2.

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.