wcsxfrm(3C)                                                     wcsxfrm(3C)

NAME
     wcsxfrm - Wide-Character-Zeichenkette transformieren

SYNTAX
     #include <wchar.h>

     sizet wcsxfrm(wchart *ws1, const wchart *ws2, sizet n);

BESCHREIBUNG
     Die Funktion wcsxfrm() transformiert die Zeichenkette aus Wide-Charac-
     ter-Werten, auf die ws2 zeigt, und legt die Ergebnis-Zeichenkette aus
     Wide-Character-Werten in dem Feld ab, auf das ws1 zeigt. Wenn die
     Funktion wcscmp() auf zwei transformierte Zeichenketten aus Wide-Char-
     acter-Werten angewendet wird, wird ein Wert größer, gleich oder klei-
     ner Null zurückgegeben, je nach dem Ergebnis der Funktion wcscoll()
     mit den beiden gleichen Ausgangs-Zeichenketten aus Wide-Character-
     Werten. Es werden maximal n Wide-Character-Werte in dem Ergebnisfeld,
     auf das ws1 zeigt, abgelegt (einschließlich abschließendem Nullbyte).
     Ist n gleich Null, kann ws1 ein Nullzeiger sein. Wenn sich überlap-
     pende Objekte ineinander kopiert werden, ist das Verhalten nicht defi-
     niert.

     Zwei transformierte Zeichenketten aus Wide-Character-Werten können von
     der Funktion wcscmp() entsprechend der Sortierreihenfolge in der
     Locale des Programms (Kategorie LCCOLLATE) sortiert werden.

     Die Tatsache, daß ws1 ein Nullzeiger sein darf, wenn n gleich Null
     ist, ist bei der Bestimmung der Größe des Feldes ws1 vor der Transfor-
     mation nützlich.

     Da für die Anzeige eines Fehlers kein Rückgabewert vorgesehen ist, muß
     eine Anwendung, die auf Fehler prüfen will, die folgenden Aktionen
     ausführen: errno wird auf Null gesetzt, wcsxfrm() aufgerufen und errno
     abgefragt. Wenn errno ein Wert ungleich Null ist, wird angenommen, daß
     ein Fehler aufgetreten ist.

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

     ENOSYS    Die Funktion wird nicht unterstützt.

ERGEBNIS
     Die Funktion wcsxfrm() gibt die Länge der transformierten Zeichenkette
     aus Wide-Character-Werten (ohne das abschließende Nullbyte) zurück.
     Wenn der zurückgegebene Wert gleich n oder größer ist, ist der Inhalt
     des Feldes, auf das ws1 zeigt, nicht definiert.

     Bei einem Fehler gibt die Funktion wcsxfrm() (sizet)-1 zurück. errno
     wird auf den Fehler gesetzt.

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




Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98