Loading...
--- Libc/Libc-498/stdlib/qsort.3
+++ Libc/Libc-262/stdlib/qsort.3
@@ -34,50 +34,24 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)qsort.3 8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/stdlib/qsort.3,v 1.15 2004/07/02 23:52:12 ru Exp $
-.\"
-.Dd September 30, 2003
+.\" $FreeBSD: src/lib/libc/stdlib/qsort.3,v 1.10 2001/09/07 14:46:35 asmodai Exp $
+.\"
+.Dd June 4, 1993
.Dt QSORT 3
.Os
.Sh NAME
-.Nm heapsort ,
-.Nm mergesort ,
-.Nm qsort ,
-.Nm qsort_r
+.Nm qsort , heapsort , mergesort
.Nd sort functions
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.In stdlib.h
+.Ft void
+.Fn qsort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
.Ft int
-.Fo heapsort
-.Fa "void *base"
-.Fa "size_t nel"
-.Fa "size_t width"
-.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
-.Fc
+.Fn heapsort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
.Ft int
-.Fo mergesort
-.Fa "void *base"
-.Fa "size_t nel"
-.Fa "size_t width"
-.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
-.Fc
-.Ft void
-.Fo qsort
-.Fa "void *base"
-.Fa "size_t nel"
-.Fa "size_t width"
-.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
-.Fc
-.Ft void
-.Fo qsort_r
-.Fa "void *base"
-.Fa "size_t nel"
-.Fa "size_t width"
-.Fa "void *thunk"
-.Fa "int \*[lp]*compar\*[rp]\*[lp]void *, const void *, const void *\*[rp]"
-.Fc
+.Fn mergesort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
.Sh DESCRIPTION
The
.Fn qsort
@@ -87,7 +61,7 @@
function is a modified selection sort.
The
.Fn mergesort
-function is a modified merge sort with exponential search,
+function is a modified merge sort with exponential search
intended for sorting data with pre-existing order.
.Pp
The
@@ -95,18 +69,16 @@
and
.Fn heapsort
functions sort an array of
-.Fa nel
+.Fa nmemb
objects, the initial member of which is pointed to by
.Fa base .
The size of each object is specified by
-.Fa width .
-The
-.Fn mergesort
-function
+.Fa size .
+.Fn Mergesort
behaves similarly, but
.Em requires
that
-.Fa width
+.Fa size
be greater than
.Dq "sizeof(void *) / 2" .
.Pp
@@ -122,58 +94,33 @@
greater than zero if the first argument is considered to be respectively
less than, equal to, or greater than the second.
.Pp
-The
-.Fn qsort_r
-function behaves identically to
-.Fn qsort ,
-except that it takes an additional argument,
-.Fa thunk ,
-which is passed unchanged as the first argument to function pointed to
-.Fa compar .
-This allows the comparison function to access additional
-data without using global variables, and thus
-.Fn qsort_r
-is suitable for use in functions which must be reentrant.
-.Pp
-The algorithms implemented by
-.Fn qsort ,
-.Fn qsort_r ,
+The functions
+.Fn qsort
and
.Fn heapsort
are
.Em not
-stable; that is, if two members compare as equal, their order in
+stable, that is, if two members compare as equal, their order in
the sorted array is undefined.
-The
-.Fn mergesort
-algorithm is stable.
-.Pp
-The
-.Fn qsort
-and
-.Fn qsort_r
-functions are an implementation of C.A.R.
-Hoare's
-.Dq quicksort
-algorithm,
-a variant of partition-exchange sorting; in particular, see
-.An D.E. Knuth Ns 's
-.%T "Algorithm Q" .
-.Sy Quicksort
+The function
+.Fn mergesort
+is stable.
+.Pp
+The
+.Fn qsort
+function is an implementation of C.A.R. Hoare's ``quicksort'' algorithm,
+a variant of partition-exchange sorting; in particular, see D.E. Knuth's
+Algorithm Q.
+.Fn Qsort
takes O N lg N average time.
This implementation uses median selection to avoid its
O N**2 worst-case behavior.
.Pp
The
.Fn heapsort
-function is an implementation of
-.An "J.W.J. William" Ns 's
-.Dq heapsort
-algorithm,
-a variant of selection sorting; in particular, see
-.An "D.E. Knuth" Ns 's
-.%T "Algorithm H" .
-.Sy Heapsort
+function is an implementation of J.W.J. William's ``heapsort'' algorithm,
+a variant of selection sorting; in particular, see D.E. Knuth's Algorithm H.
+.Fn Heapsort
takes O N lg N worst-case time.
Its
.Em only
@@ -186,30 +133,26 @@
The function
.Fn mergesort
requires additional memory of size
-.Fa nel *
-.Fa width
+.Fa nmemb *
+.Fa size
bytes; it should be used only when space is not at a premium.
-The
-.Fn mergesort
-function
+.Fn Mergesort
is optimized for data with pre-existing order; its worst case
time is O N lg N; its best case is O N.
.Pp
Normally,
.Fn qsort
is faster than
-.Fn mergesort ,
-which is faster than
+.Fn mergesort
+is faster than
.Fn heapsort .
Memory availability and pre-existing order in the data can make this
untrue.
.Sh RETURN VALUES
The
.Fn qsort
-and
-.Fn qsort_r
-functions
-return no value.
+function
+returns no value.
.Pp
.Rv -std heapsort mergesort
.Sh ERRORS
@@ -221,20 +164,18 @@
.Bl -tag -width Er
.It Bq Er EINVAL
The
-.Fa width
+.Fa size
argument is zero, or,
the
-.Fa width
+.Fa size
argument to
.Fn mergesort
is less than
.Dq "sizeof(void *) / 2" .
.It Bq Er ENOMEM
-The
-.Fn heapsort
+.Fn Heapsort
or
.Fn mergesort
-functions
were unable to allocate memory.
.El
.Sh COMPATIBILITY
@@ -271,19 +212,16 @@
.%P pp. 114-123, 145-149
.Re
.Rs
-.%A McIlroy, P.M.
+.%A Mcilroy, P.M.
.%T "Optimistic Sorting and Information Theoretic Complexity"
.%J "Fourth Annual ACM-SIAM Symposium on Discrete Algorithms"
.%V January 1992
.Re
.Rs
.%A Bentley, J.L.
-.%A McIlroy, M.D.
.%T "Engineering a Sort Function"
-.%J "Software--Practice and Experience"
-.%V Vol. 23(11)
-.%P pp. 1249-1265
-.%D November\ 1993
+.%J "bentley@research.att.com"
+.%V January 1992
.Re
.Sh STANDARDS
The