F278_DSORT

Trier des données dans un tableau de données de 32 bits (ordre décroissant ou croissant)

La fonction trie les valeurs (avec signes +/-) dans un tableau de données dans l’ordre croissant ou décroissant.

Paramètres

Entrée

s1_Start (DINT)

Zone de départ du tableau des données qui doivent être triées

s2_End (DINT)

Zone finale du tableau des données qui doivent être triées

s3_Descending (INT)

Indique l’ordre de tri :

0 = croissant
1 = décroissant

Remarques

Au lieu d’utiliser cette instruction F, nous recommandons d’utiliser l’instruction FP7 correspondante : FP_DATA_SORT
Les données sont triées, via un procédé de tri par permutation (tri à bulles), dans l’ordre indiqué par la valeur en entrée s3_Descending. Puisque le nombre de comparaisons de mots correspond au nombre de mots au carré, le tri peut prendre quelque temps lorsqu’il y a un grand nombre de mots. Lorsque la valeur en entrée s1_Start=s2_End, aucun tri n’a lieu.
Bien qu’il s’agisse d’une instruction de 32 bits, le nombre d’étapes est le même que dans une instruction 16 bits.

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 l’adresse de la variable en entrée s1_Start > s2_End.
Si s1_Start et s2_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 l’adresse de la variable en entrée s1_Start > s2_End.
Si s1_Start et s2_End appartiennent à différentes zones de données.

Thèmes apparentés

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
		start: BOOL:=FALSE;
			(*activates the function*)
		data_array: ARRAY [0..4] OF DINT:=[4,7,-32,13,5];
			(*result after a 0->1 leading
edge from start: [-32,4,5,7,13]*)
		asc_order: INT:=0;
			(*which way to sort:
0 means ascending order
1 means descending order*)
	END_VAR

Dans cet exemple, la variable d’entrée sort_order est déclarée. Vous pouvez aussi entrer directement une constante au contact d’entrée de la fonction.

Corps du POU

La fonction est exécutée lorsque la variable start est sur TRUE.

La variable sort_order étant définie sur 1, la zone de données indiquée est triée dans l’ordre décroissant.

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 := 9 ;
        NETWORK_BODY
B(B_VARIN,,output,7,1,9,3,);
B(B_VARIN,,data field[0],7,2,9,4,);
B(B_VARIN,,data field[4],7,3,9,5,);
B(B_F,F278_DSORT,,9,0,18,6,,?DEN?D@'s1'?Ds2?Ds3?AENO);
B(B_VARIN,,sort_order,7,4,9,6,);
B(B_COMMENT,,sorting order:Ã¸^s3 = 0:ascending~ 1:descending,10,6,25,8,);
L(1,0,1,9);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

Corps en ST

IF start then
    F278_DSORT( s1_Start:= data_field[0],
         s2_End:= data_field[4],
         s3_Descending:= sort_order);
END_IF;