LEN

Longueur de la chaîne de caractères

La fonction LEN calcule la longueur de la chaîne de caractères d’entrée et écrit le résultat dans la variable de sortie.

Paramètres

Entrée

Unnamed input (STRING): Type de données d’entrée

Sortie

Unnamed output (INT): Longueur de la chaîne de caractères

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_string: STRING[12]:='Panasonic';
			(*sample string*)
		output_value: INT:=0;
			(*result: here 9*)
	END_VAR

Dans cet exemple, la variable d’entrée (input_string) a été déclarée. Vous pouvez également entrer la chaîne de caractères ('Panasonic') directement dans la fonction. La chaîne de caractères doit être entrée entre guillemets, à la fois dans l’en-tête du POU et dans la fonction.

Corps du POU

La longueur (9) de la chaîne de caractères input_string ('Panasonic’) est écrite dans output_value.

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 := 2 ;
        NETWORK_BODY
B(B_F,LEN!,Instance,9,0,14,2,,?DIN?C);
B(B_VARIN,,input_string,7,0,9,2,);
B(B_VAROUT,,output_value,14,0,16,2,);
L(1,0,1,2);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

Corps en ST

output_value:=LEN(input_value);

Corps en IL

LD	input_value
LEN
ST	output_value