FP_DATA_SEARCH

Rechercher des données

Cette instruction FP recherche la valeur spécifiée par s1 dans l’intervalle indiqué par s2_Start et s3_End lorsque le déclencheur EN est TRUE.

Paramètres

Entrée

s1 (INT, DINT, UINT, UDINT, REAL, LREAL): Données à rechercher
s2_Start (INT, DINT, UINT, UDINT, REAL, LREAL): Début de la plage de recherche
s3_End (INT, DINT, UINT, UDINT, REAL, LREAL): Fin de la plage de recherche

Sortie

d1_Count (DINT): Nombre de résultats trouvés
d2_Pos (DINT): Position relative de la première valeur trouvée (la première position est 0)

Remarques

s2_Start doit être £s3_End
Les variables s1, s2_Start et s3_End doivent être du même type de données.
Le nombre maximum de données pouvant être recherchées est de 30000.

Drapeaux d’erreur

sys_bIsOperationErrorHold (passe à TRUE et reste TRUE)

Si la zone spécifiée à l’aide du modificateur d’adresse est en dehors des limites autorisées.
Si s2_Start>s3_End
Si s2_Start et s3_End appartiennent à différentes zones de données.

sys_bIsOperationErrorNonHold (passe à TRUE pendant un cycle)

Si la zone spécifiée à l’aide du modificateur d’adresse est en dehors des limites autorisées.
Si s2_Start>s3_End
Si s2_Start et s3_End appartiennent à différentes zones de données.

Thèmes apparentés

Instructions F correspondantes : F96_SRC

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
		bStart: BOOL:=FALSE;
			(*activates the fuction*)
		diSearch_value: DINT:=16#20;
			(*specifies the value to
search for*)
		adiDataField: ARRAY [0..3] OF DINT:=[16#101,16#20,16#2A04,16#20];
			(*2 matches for 16#20
data_array[2] = 1st match*)
		diNumber_matches: DINT:=0;
		diPosition1_match: DINT:=0;
	END_VAR

Corps du POU

La fonction est exécutée lorsque la variable bStart est définie sur TRUE.

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 := 7 ;
        NETWORK_BODY
B(B_CONTACT,,bStart,6,2,8,4,);
B(B_VARIN,,diSearch_value,11,3,13,5,);
B(B_VARIN,,adiDataField[0],11,4,13,6,);
B(B_VARIN,,adiDataField[3],11,5,13,7,);
B(B_F,FP_DATA_SEARCH!,,13,1,23,7,,?DEN?D@'s1'?Ds2_Start?Ds3_End?AENO?Cd1_Count?Cd2_Pos);
B(B_VAROUT,,diNumber_matches,23,3,25,5,);
B(B_VAROUT,,diPosition1_match,23,4,25,6,);
L(8,3,13,3);
L(1,3,6,3);
L(1,0,1,7);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

Corps en ST

IF bStart then
    FP_DATA_SEARCH(s1 := diSearch_value, 
                   s2_Start := adiDataField[0], 
                   s3_End := adiDataField[3], 
                   d1_Count => diNumber_matches, 
                   d2_Pos => diPosition1_match);
END_IF;