wcscoll - zwei Langzeichenketten gemäß LC_COLLATE vergleichen

Definition	#include <wchar.h> int wcscoll(const wchar_t *ws1, const wchar_t *ws2);
Beschreibung	wcscoll() vergleicht zwei Langzeichenketten ws1 und ws2 lexikalisch unter Berücksichtigung der in LC_COLLATE für die Lokalität festgelegten Sortierreihenfolge.
Returnwert	Ganzzahliger Wert, und zwar:
	< 0	ws1 ist bezüglich der festgelegten Sortierreihenfolge kleiner als ws2.
	= 0	ws1 und ws2 sind bezüglich der festgelegten Sortierreihenfolge gleich groß.
	> 0	ws1 ist bezüglich der festgelegten Sortierreihenfolge größer als ws2.
Fehler	wcscoll() schlägt fehl, wenn gilt:
	EINVAL	Eine der beiden Langzeichenketten lässt sich nicht in eine Multibyte-Zeichenkette umwandeln.
Hinweise	Da es im Standard keinen festlegten Wert für den Fehlerfall gibt, wird empfohlen, errno auf den Wert 0 zu setzen, dann wcscoll() aufzurufen und nach dem Aufruf errno zu überprüfen. Falls errno ungleich 0 ist, kann angenommen werden, dass ein Fehler aufgetreten ist. Zum Sortieren großer Listen sollten die Funktionen wcsxfmr() und wcscmp() verwendet werden. Einschränkung In dieser Version des C-Laufzeitsystems werden nur 1-Byte-Zeichen als Langzeichen unterstützt. Sie sind vom Typ wchar_t (siehe stddef.h). (Ende)
Siehe auch	wcsncmp(), wcsxfrm(), wchar.h.