wcscoll(3C)                                                     wcscoll(3C)

NAME
     wcscoll - Wide-Character-Zeichenketten vergleichen

SYNTAX
     #include <wchar.h>

     int wcscoll(const wchart *ws1, const wchart *ws2);

BESCHREIBUNG
     Die Funktion wcscoll() vergleicht die Zeichenkette aus Wide-Charac-
     ter-Werten, auf die ws1 zeigt, mit der Zeichenkette aus Wide-Charac-
     ter-Werten, auf die ws2 zeigt. Beide werden entsprechend der Kategorie
     LCCOLLATE der aktuellen Locale interpretiert.

     Da für die Anzeige von Fehlern kein Rückgabewert vorgesehen ist, muß
     eine Anwendung, die auf Fehler prüfen will, errno auf 0 setzen,
     wcscoll() aufrufen und errno abfragen. Wenn errno ungleich Null ist,
     muß angenommen werden, daß ein Fehler aufgetreten ist.

     Für das Sortieren großer Listen sollten die Funktionen wcsxfrm() und
     wcscmp() verwendet werden.

     Die Funktion wcscoll() schlägt fehl, wenn:

     EINVAL    Das Argument ws1 oder ws2 enthält Wide-Character-Werte, die
               nicht in der Sortierreihenfolge enthalten sind.

     ENOSYS    Die Funktion wird nicht unterstützt.

ERGEBNIS
     Bei erfolgreicher Beendigung gibt die Funktion wcscoll() einen
     Integer-Wert zurück, der größer, gleich oder kleiner Null ist (je
     nachdem, ob die Zeichenkette aus Wide-Character-Werten, auf die ws1
     zeigt, größer, gleich oder kleiner als die Zeichenkette aus Wide-
     Character-Werten ist, auf die ws2 zeigt), wenn beide Zeichenketten
     entsprechend der aktuellen Locale interpretiert werden.

SIEHE AUCH
     wcscmp(3C), wcsxfrm(3C), wchar(5).
















Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98