newlib/libc/string/wcscoll.c

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