toolchain/gcc/newlib/libc/string/strcoll.c

   1 /*
   2 FUNCTION
   3         <<strcoll>>---locale specific character string compare
   4
   5 INDEX
   6         strcoll
   7
   8 ANSI_SYNOPSIS
   9         #include <string.h>
  10         int strcoll(const char *<[stra]>, const char * <[strb]>);
  11
  12 TRAD_SYNOPSIS
  13         #include <string.h>
  14         int strcoll(<[stra]>, <[strb]>)
  15         char *<[stra]>;
  16         char *<[strb]>;
  17
  18 DESCRIPTION
  19         <<strcoll>> compares the string pointed to by <[stra]> to
  20         the string pointed to by <[strb]>, using an interpretation
  21         appropriate to the current <<LC_COLLATE>> state.
  22
  23 RETURNS
  24         If the first string is greater than the second string,
  25         <<strcoll>> returns a number greater than zero.  If the two
  26         strings are equivalent, <<strcoll>> returns zero.  If the first
  27         string is less than the second string, <<strcoll>> returns a
  28         number less than zero.
  29
  30 PORTABILITY
  31 <<strcoll>> is ANSI C.
  32
  33 <<strcoll>> requires no supporting OS subroutines.
  34
  35 QUICKREF
  36         strcoll ansi pure
  37 */
  38
  39 #include <string.h>
  40
  41 int
  42 _DEFUN (strcoll, (a, b),
  43         _CONST char *a _AND
  44         _CONST char *b)
  45
  46 {
  47   return strcmp (a, b);
  48 }