qsort_s.gml

来自「开放源码的编译器open watcom 1.6.0版的源代码」· GML 代码 · 共 85 行

.func qsort_s
#define __STDC_WANT_LIB_EXT1__ 1
#include <stdlib.h>
errno_t qsort_s( void *base,
                 rsize_t nmemb,
                 rsize_t size,
    int (*compar)( const void *x, const void *y, void *context ),
                 void *context );
.funcend
.*
.rtconst begin
Neither
.arg nmemb
nor
.arg size
shall be greater than
.kw RSIZE_MAX.
If
.arg nmemb
is not equal to zero, then neither
.arg base
nor
.arg compar
shall be a null pointer.
If there is a runtime-constraint violation, the &func function does not sort the array.
.rtconst end
.*
.desc begin
The &func function sorts an array of
.arg nmemb
objects, the initial element of which is
pointed to by
.arg base.
The size of each object is specified by
.arg size.
The contents of the array are sorted into ascending order according to a comparison
function pointed to by
.arg compar,
which is called with three arguments. The first two
point to the objects being compared. The function shall return an integer less than, equal
to, or greater than zero if the first argument is considered to be respectively less than,
equal to, or greater than the second. The third argument to the comparison function is the
.arg context
argument passed to &func. The sole use of
.arg context
by &func is to pass it to the comparison function.
If two elements compare as equal, their relative order in the resulting sorted array is
unspecified.
.desc end
.return begin
The &func function returns zero if there was no runtime-constraint violation.
Otherwise, a non-zero value is returned.
.return end
.see begin
.seelist qsort_s qsort bsearch bsearch_s
.see end
.exmp begin
#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

char *CharVect[] = { "last", "middle", "first" };
.exmp break
int compare( const void *op1, const void *op2, void *context )
{
    const char **p1 = (const char **) op1;
    const char **p2 = (const char **) op2;
    return( strcmp( *p1, *p2 ) );
}
.exmp break
void main()
{
    void * context = NULL;
    qsort_s( CharVect, sizeof(CharVect)/sizeof(char *),
          sizeof(char *), compare, context );
    printf( "%s %s %s\n",
            CharVect[0], CharVect[1], CharVect[2] );
}
.exmp output
first last middle
.exmp end
.class TR 24731
.system