INSERT

Insérer des caractères

INSERT insère la chaîne de caractères indiquée en entrée IN2 dans la chaîne de caractères indiquée en entrée IIN1 à partir de la position P, 0 indiquant la position du premier caractère de la chaîne de caractères, 1 la position suivant le premier caractère, etc. Le résultat est écrit dans la variable de sortie.

Paramètres

Entrée

IN1 (STRING): Chaîne de caractères d’entrée
IN2 (STRING): Chaîne de caractères à insérer dans la chaîne de caractères d’entrée
P (INT): Position à partir de laquelle la chaîne de caractères IN2 est insérée dans la chaîne de caractères IN1, 0 indiquant la position du premier caractère de la chaîne de caractères, 1 la position suivant le premier caractère

Sortie

Unnamed output (STRING): Chaîne de caractères résultante

Remarques

Si cette instruction est utilisée avec des chaînes de caractères en UTF-8, consultez les remarques concernant les chaînes de caractères en UTF-8 sous “STRING”.
Si les chaînes de caractères sont d’une longueur supérieure à celle définie pour les variables d’entrée (IN1 et IN2) dans la zone Type, une erreur apparaît (voir sys_bIsCarry pour le traitement des erreurs).

Drapeaux d’erreur

sys_bIsOperationErrorHold (passe à TRUE et reste TRUE): Si une chaîne de caractères en entrée ou sortie est invalide.
sys_bIsOperationErrorNonHold (passe à TRUE pendant un cycle): Si une chaîne de caractères en entrée ou sortie est invalide.

Thèmes apparentés

STRING

Chaînes de caractères invalides

Exemple

En-tête du POU

Toutes les variables d’entrée et de sortie utilisées pour programmer cette fonction ont été déclarées dans l’en-tête du POU. Le même en-tête de POU est utilisé pour tous les langages de programmation.

	VAR
		input_string1: STRING[32]:='ideas life';
		input_string2: STRING[32]:='for';
		position: INT:=6;
		output_string: STRING[32]:='';
	END_VAR

Corps du POU

Dans cet exemple, les variables d’entrée input_string1, input_string2 et position ont été déclarées. Cependant, vous pouvez également entrer les valeurs directement aux contacts d’entrée de la fonction. Les chaînes de caractères doivent être entrées entre guillemets, dans l’en-tête du POU et aux contacts d’entrée. input_string2 ('for ') est insérée dans input_string1 ('Ideas life') à partir de la position 6. Le résultat ('Ideas for life') est renvoyé en sortie output_value. Dans l’exemple LD, l’icône de monitoring est activé pendant le mode en ligne. Vous pouvez ainsi voir le résultat immédiatement.

Corps en LD

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_F,INSERT!,Instance,9,0,14,5,,?DIN1?DIN2?DP?C);
B(B_VARIN,,input_string1,7,1,9,3,);
B(B_VARIN,,input_string2,7,2,9,4,);
B(B_VARIN,,position,7,3,9,5,);
B(B_VAROUT,,output_string,14,1,16,3,);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

Corps en ST

output_value:=INSERT(IN1:=input_string1, IN2:=input_string2, P:=6);