summaryrefslogtreecommitdiff
path: root/static/v10/man3/compar.3
diff options
context:
space:
mode:
Diffstat (limited to 'static/v10/man3/compar.3')
-rw-r--r--static/v10/man3/compar.343
1 files changed, 43 insertions, 0 deletions
diff --git a/static/v10/man3/compar.3 b/static/v10/man3/compar.3
new file mode 100644
index 00000000..3fc488d5
--- /dev/null
+++ b/static/v10/man3/compar.3
@@ -0,0 +1,43 @@
+.pa 1
+.he 'COMPAR (III)'1/15/73'COMPAR (III)'
+.ti 0
+NAME compar -- default comparison routine for qsort
+.sp
+.ti 0
+SYNOPSIS jsr pc,compar
+.sp
+.ti 0
+DESCRIPTION Compar is the default comparison routine
+called by qsort and is separated out so that the user can
+supply his own comparison.
+.sp
+The routine is called with the width (in bytes) of
+an element in r3 and it compares byte-by-byte the element
+pointed to by r0 with the element pointed to by r4.
+.sp
+Return is via the condition codes,
+which are tested by the instructions "blt" and "bgt".
+.a
+That is, in the absence of overflow, then the
+condition (r0) < (r4) should leave the Z-bit off and N-bit
+on while (r0) > (r4) should leave Z and N off.
+Still another way of putting it is that for elements
+of length 1 the instruction
+
+ cmpb (r0),(r4)
+
+suffices.
+.sp
+Only r0 is changed by the call.
+.sp
+.ti 0
+FILES kept in /lib/liba.a
+.sp
+.ti 0
+SEE ALSO qsort (III)
+.sp
+.ti 0
+DIAGNOSTICS --
+.sp
+.ti 0
+BUGS It could be recoded to run faster.