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

   1 /*
   2 FUNCTION
   3         <<wcscoll>>---locale specific wide-character string compare
   4
   5 INDEX
   6         wcscoll
   7
   8 ANSI_SYNOPSIS
   9         #include <wchar.h>
  10         int wcscoll(const wchar_t *<[stra]>, const wchar_t * <[strb]>);
  11
  12 TRAD_SYNOPSIS
  13         #include <wchar.h>
  14         int wcscoll(<[stra]>, <[strb]>)
  15         wchar_t *<[stra]>;
  16         wchar_t *<[strb]>;
  17
  18 DESCRIPTION
  19         <<wcscoll>> compares the wide-character string pointed to by
  20         <[stra]> to the wide-character string pointed to by <[strb]>,
  21         using an interpretation appropriate to the current <<LC_COLLATE>>
  22         state.
  23
  24         The current implementation of <<wcscoll>> simply uses <<wcscmp>>
  25         and does not support any language-specific sorting.
  26
  27 RETURNS
  28         If the first string is greater than the second string,
  29         <<wcscoll>> returns a number greater than zero.  If the two
  30         strings are equivalent, <<wcscoll>> returns zero.  If the first
  31         string is less than the second string, <<wcscoll>> returns a
  32         number less than zero.
  33
  34 PORTABILITY
  35 <<wcscoll>> is ISO/IEC 9899/AMD1:1995 (ISO C).
  36 */
  37
  38 #include <_ansi.h>
  39 #include <wchar.h>
  40
  41 int
  42 _DEFUN (wcscoll, (a, b),
  43         _CONST wchar_t *a _AND
  44         _CONST wchar_t *b)
  45
  46 {
  47   return wcscmp (a, b);
  48 }