newlib/libc/string/wcscoll_l.c

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