aboutsummaryrefslogtreecommitdiff
path: root/newlib/libc/string/wcscoll_l.c
blob: e71d02a752b5dde31d9caa04289652011bfc9adb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
/*
FUNCTION
	<<wcscoll_l>>---locale-specific wide-character string compare
	
INDEX
	wcscoll_l

ANSI_SYNOPSIS
	#include <wchar.h>
	int wcscoll_l(const wchar_t *<[stra]>, const wchar_t * <[strb]>,
		      locale_t <[locale]>);

DESCRIPTION
	<<wcscoll_l>> compares the wide-character string pointed to by
	<[stra]> to the wide-character string pointed to by <[strb]>,
	using an interpretation appropriate to the current <<LC_COLLATE>>
	state.

	(NOT Cygwin:) The current implementation of <<wcscoll_l>> simply
	uses <<wcscmp>> and does not support any language-specific sorting.

	If <[locale]> is LC_GLOBAL_LOCALE or not a valid locale object, the
	behaviour is undefined.

RETURNS
	If the first string is greater than the second string,
	<<wcscoll_l>> returns a number greater than zero.  If the two
	strings are equivalent, <<wcscoll_l>> returns zero.  If the first
	string is less than the second string, <<wcscoll_l>> returns a
	number less than zero.

PORTABILITY
<<wcscoll_l>> is POSIX-1.2008.
*/

#include <_ansi.h>
#include <wchar.h>

int
wcscoll_l (const wchar_t *a, const wchar_t *b, struct __locale_t *locale)
{
  return wcscmp (a, b);
}