REPLACE_INT : remplacement d'une sous-chaîne de caractères
Traduction de la notice originale
A propos de nous
Description de la fonction
La fonction REPLACE_INT remplace une chaîne de caractères dans une autre chaîne de caractères à partir d'un certain rang et sur une longueur donnée. Le résultat est une chaîne de caractères.
Les paramètres supplémentaires EN et ENO peuvent être configurés.
NOTE : Si la chaîne Result_String de cette fonction se trouve sur %MW, elle n'est pas complétée par des caractères NUL (16#00). Il est recommandé d'effacer le contenu de la chaîne Result_String avant d'utiliser cette fonction.
Représentation en FBD
Représentation :
Représentation en LD
Représentation :
Représentation en IL
Représentation : 
LD String1
REPLACE_INT String2, Length_Str, Position
ST Result_String
Représentation en ST
Représentation : 
Result_String:= REPLACE_INT(String1, String2, Length_Str, Position);
Description des paramètres
Le tableau suivant décrit les paramètres d’entrée :
Paramètre
Type
Commentaire
String1
STRING
Chaîne de caractères originale dans laquelle est insérée une sous-chaîne de caractères à partir de Position sur la longueur Length_Str.
Exemple : String1 contient "SWITCH TO RUN"
Remarque : Length_Str est la longueur du texte à remplacer et non celle de la chaîne String2. En effet, la chaîne de remplacement peut avoir une longueur différente de la chaîne remplacée.
String2
STRING
Chaîne de caractères à insérer dans String1 pour remplacer les caractères existants.
Exemple : String2 contient "STOP"
Length_Str
INT
Nombre de caractères à remplacer dans String1 par String2
Exemple : Length_Str =3
Position
INT
Rang du premier caractère de la sous-chaîne à remplacer
Exemple : Position =11
Le tableau suivant décrit les paramètres de sortie :
Paramètre
Type
Commentaire
Result_String
STRING
La chaîne String2 a remplacé Length_Str caractères à partir du rang Position de la chaîne String1 pour former Result_String.
Exemple : pour les valeurs de l'exemple fourni dans le tableau précédent, Result_String contient "SWITCH TO STOP".
Erreurs d'exécution
Le bit %S15 est réglé sur 1 dans les cas suivants :