QSORT(3)

名前
qsort - 配列を並べ変える

書式
#include <stdlib.h>

void qsort(void *base, size_t nmemb, size_t size,
    int (*compar)(const void *, const void *))

説明
qsort() 関数は、 大きさsizeのnmemb個の要素をもつ配列を並べ変える。 base 引数は配列の先頭へのポインタである。

comparをポインタとする比較関数によって、 配列の中身は昇順(値の大きいものほど後に並ぶ順番)に並べられる。 比較関数の引数は比較されるふたつのオブジェクトのポインタである。

比較関数は、第一の引数が第二の引数に対して、 1)小さい、2)等しい、3)大きいならば、 1)ゼロ未満、2)ゼロ、3)ゼロより大きい整数のいずれかを返さなければならない。 二つの要素が等しいとき、 並べ替えた後の配列における、ふたつの順序は定義されていない。

返り値
qsort()は値を返さない。

準拠
SVID 3, POSIX, BSD 4.3, ISO 9899

SEE ALSO
sort(1)