F278_DSORT

Clasificación de palabras de 32 bits (en orden creciente o decreciente)

La función clasifica los valores (con signo +/- ) de una tabla en orden creciente o decreciente.

Parámetros

Entrada

s1_Start (DINT)

Área inicial de la tabla a ordenar

s2_End (DINT)

Área final de la tabla a ordenar

s3_Descending (INT)

Especifica el orden:

0 = creciente
1 = decreciente

Observaciones

En lugar de utilizar esta instrucción F, se recomienda utilizar la instrucción FP7 correspondiente: FP_DATA_SORT
Los datos se ordenan con el método de la burbuja en el orden especificado en la entrada s3_Descending. Puesto que el número de comparaciones aumenta a razón del cuadrado de las palabras a ordenar, la ordenación puede ser ineficiente (alto tiempo de ejecución) para tablas que tengan un gran número de elementos. Cuando el valor en las entradas s1_Start=s2_End, no se realiza la ordenación.
Aunque esta es una instrucción de 32 bits, el número de pasos es el mismo que en la instrucción de 16 bits

Banderas de error

sys_bIsOperationErrorHold (pasa a TRUE y permanece TRUE)

si el área especificada utilizando el modificador índice supera el límite.
si la dirección de la variable de entrada s1_Start > s2_End.
Si s1_Start y s2_End pertenecen a diferentes áreas de datos

sys_bIsOperationErrorNonHold (pasa a TRUE para un ciclo de scan)

si el área especificada utilizando el modificador índice supera el límite.
si la dirección de la variable de entrada s1_Start > s2_End.
Si s1_Start y s2_End pertenecen a diferentes áreas de datos

Temas relacionados

FP_DATA_SORT

Instrucciones del sistema

Panel Instrucciones

Áreas de memoria

Tipos de datos

Ejemplo

Cabecera de la POU

Todas las variables de entrada y de salida utilizadas para la programación de esta función han sido declaradas en la Cabecera de la POU. Se utiliza la misma cabecera de la POU para todos los lenguajes de programación.

	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

En este ejemplo se ha declarado la variable de entrada sort_order. Sin embargo, se puede introducir una constante directamente en la entrada de la función.

Cuerpo de la POU

Cuando la variable start está ajustada a TRUE, se ejecuta la función.

Puesto que la variable sort_order está a 1, los datos se ordenan en sentido descendente.

Cuerpo 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

Cuerpo en ST

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