Funzione EngSort (winddi.h)

La funzione EngSort esegue un ordinamento rapido nell'elenco specificato.

Sintassi

ENGAPI VOID EngSort(
  [in, out] PBYTE    pjBuf,
  [in]      ULONG    c,
  [in]      ULONG    cjElem,
  [in]      SORTCOMP pfnComp
);

Parametri

[in, out] pjBuf

Puntatore alla matrice di dati da ordinare.

[in] c

Specifica le dimensioni, in byte, di ogni elemento in pjBuf.

[in] cjElem

Specifica il numero di elementi in pjBuf da ordinare.

[in] pfnComp

Puntatore a una funzione che implementa il confronto degli elementi da usare per l'ordinamento.

Valore restituito

nessuno

Osservazioni

EngSort implementa un algoritmo di ordinamento rapido per ordinare gli elementi cjElem in pjBuf, dove ogni elemento è di dimensioni c. Gli elementi ordinati vengono restituiti in pjBuf; ovvero il contenuto originale del buffer viene sovrascritto con i risultati ordinati.

La base per confrontare due elementi è definita nella funzione a cui pfnComp punta. Questa funzione viene prototipo come indicato di seguito:

int (__cdecl *SORTCOMP)(const void *pv1, const void *pv2);

dove pv1 e pv2 puntano ai due elementi da confrontare. Il valore restituito è il risultato del confronto definito come segue:

La matrice viene ordinata in ordine crescente, definito dal parametro pfnComp .

Requisiti