qsort

Download PDF

void qsort (void *baseArrayElement, size_t numberOfElements, size_t elementSize, int (*comparisonFunction)(const void *, const void *));

Purpose

Sorts an array of elements into ascending order according to a comparison function written by the user.

Input

Name Type Description

baseArrayElement void * Contains a pointer to the initial element of the array that is sorted.

numberOfElements size_t Specifies the number of elements in the array that are sorted.

elementSize size_t Contains the size in bytes of the array elements that are sorted.

comparisonFunction

int (*)(const void *, const void *)

Contains the name of a comparison function written by the user. This comparison function must have the following characteristics:

A prototype similar to:

int compar(const void *element1, const void *element2);
The following relationships between arguments and return values:

If element1 is... compar returns...

Less than element2 Less than zero

Equal to element2 Zero

Greater than element2 Greater than zero

None.

Library: ANSI C Library

Include file: ansi_c.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later

Was this information helpful?