Index Index for
Section 3
Index Alphabetical
listing for Q
Bottom of page Bottom of
page

qsort(3)

NAME

qsort - Sort a table in place

SYNOPSIS

#include <stdlib.h> void qsort( void *base, size_t nmemb, size_t size, int (*compar)(const void *, const void *) );

LIBRARY

Standard C Library (libc)

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows: qsort(): XPG4, XPG4-UNIX Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

base Points to the first entry in the table. nmemb Specifies the number of entries in the table. size Specifies the size in bytes of each table entry. compar Points to the user-specified function to be used to compare pairs of table elements. The comparison function will be called with two parameters that point to the two elements to be compared. The comparison function must return an integer less than, equal to, or greater than zero, depending on whether the first element in the comparison is considered less than, equal to, or greater than the second element.

DESCRIPTION

The qsort() function sorts a table having a specified number of entries. The contents of the table are sorted in ascending order according to a user-specified comparison function (the strcmp() function, for example).

NOTES

The comparison function need not compare every byte, so arbitrary data may be contained in the elements in addition to the values being compared. When two members compare equal, their order in the sorted array is indeterminate.

SEE ALSO

Functions: bsearch(3) lsearch(3) Standards: standards(5)

Index Index for
Section 3
Index Alphabetical
listing for Q
Top of page Top of
page