BOOL_TO_STRING

BOOL en STRING

La fonction BOOL_TO_STRING convertit une valeur du type de données BOOL en une valeur du type de données STRING[2]. La chaîne de caractères, résultat de la conversion, est représentée par '0' ou '1'.

Paramètres

Entrée

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

Sortie

Unnamed output (STRING): Résultat de la conversion

Remarques

Si vous utilisez le type de données STRING avec des petits automates tels que FP-e ou FP0, veillez à ce que la longueur de la chaîne, résultat de la conversion, soit égale ou supérieure à celle de la chaîne de départ.

Thèmes apparentés

Exemple : chaîne de caractère, résultat de la conversion = '0' ou '1'

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_value: BOOL:=FALSE;
		result_string: STRING;
	END_VAR

La variable d’entrée input_value du type de données BOOL est initialisée par la valeur TRUE. La variable de sortie result_string est du type de données STRING[2]. Elle peut enregistrer un maximum de deux caractères. Vous pouvez déclarer une chaîne de caractères ayant plus d'un caractère, par exemple, STRING[5]. Sur les 5 caractères réservés, seuls 2 sont utilisés.

À défaut d’utiliser la variable input_value, vous pouvez aussi entrer la constante TRUE ou FALSE directement au contact d’entrée de la fonction, dans le corps.

Corps du POU

La variable input_value du type de données BOOL est convertie en STRING[2]. La valeur convertie est écrite dans result_string. Lorsque la variable input_value = TRUE, result_string indique ' 1'.

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,BOOL_TO_STRING!,Instance,9,1,19,3,,?D?C);
B(B_VARIN,,input_value,7,1,9,3,);
B(B_VAROUT,,result_string,19,1,21,3,);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

Corps en ST

IF Boolean_value then
    output_value:=BOOL_TO_STRING(input_value);
END_IF;

Corps en IL

Exemple : chaîne de caractère, résultat de la conversion = 'TRUE' ou 'FALSE'

En-tête du POU

Si vous souhaitez afficher le résultat 'TRUE' ou 'FALSE' à la place de '0' ou '1', vous ne pouvez pas utiliser la fonction BOOL_TO_STRING. Cet exemple illustre comment créer une chaîne de caractères STRING[5] qui comprend les caractères 'TRUE' ou 'FALSE' à partir d’une valeur d’entrée du type de données BOOL. 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_value: BOOL:=TRUE;
			(*example value*)
		result_string: STRING[5]:='';
			(*result: here TRUE*)
		@'': @'';
		@'': @'';
	END_VAR

Dans cet exemple, la variable d’entrée input_value du type de données BOOL et la variable de sortie result_string du type STRING[5] sont déclarées.

Corps du POU

Pour réaliser l’opération souhaitée, la fonction standard MOVE est utilisée. Elle assigne la valeur des entrées aux sorties sans modification. La constante STRING 'TRUE' ou 'FALSE' est indiquée en entrée. Une conversion comparable à "BOOL to STRING" est effectuée, la variable booléenne input_variable en entrée de validation (EN) déterminant la sortie de type STRING.

Corps en LD

BODY
    WOKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORRKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 8 ;
        NETWORK_BODY
B(B_CONTACT,,input_value,3,1,5,3,);
B(B_F,E_MOVE!,Instanz,11,0,17,4,,?DEN?D?AENO?C);
B(B_VARIN,,'TRUE',9,2,11,4,);
B(B_VAROUT,,result_string,17,2,19,4,);
B(B_F,E_MOVE!,Instanz,11,4,17,8,N,?DEN?D?AENO?C);
B(B_VARIN,,'FALSE',9,6,11,8,);
B(B_VAROUT,,result_string,17,6,19,8,);
L(1,2,3,2);
L(5,2,11,2);
L(1,0,1,8);
L(6,2,6,6);
L(6,6,11,6);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY