newlib-2.4.0: wide character strings

git-svn-id: svn://kolibrios.org@6557 a494cfbc-eb01-0410-851d-a64ba20cac60

contrib/sdk/sources/newlib/libc/string/wcscoll.c

@@ -0,0 +1,48 @@
+/*
+FUNCTION
+	<<wcscoll>>---locale-specific wide-character string compare
+	
+INDEX
+	wcscoll
+
+ANSI_SYNOPSIS
+	#include <wchar.h>
+	int wcscoll(const wchar_t *<[stra]>, const wchar_t * <[strb]>);
+
+TRAD_SYNOPSIS
+	#include <wchar.h>
+	int wcscoll(<[stra]>, <[strb]>)
+	wchar_t *<[stra]>;
+	wchar_t *<[strb]>;
+
+DESCRIPTION
+	<<wcscoll>> 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.
+
+	The current implementation of <<wcscoll>> simply uses <<wcscmp>>
+	and does not support any language-specific sorting.
+
+RETURNS
+	If the first string is greater than the second string,
+	<<wcscoll>> returns a number greater than zero.  If the two
+	strings are equivalent, <<wcscoll>> returns zero.  If the first
+	string is less than the second string, <<wcscoll>> returns a
+	number less than zero.
+
+PORTABILITY
+<<wcscoll>> is ISO/IEC 9899/AMD1:1995 (ISO C).
+*/
+
+#include <_ansi.h>
+#include <wchar.h>
+
+int
+_DEFUN (wcscoll, (a, b),
+	_CONST wchar_t *a _AND
+	_CONST wchar_t *b)
+
+{
+  return wcscmp (a, b);
+}