wcsftime(3C)                                                   wcsftime(3C)

NAME
     wcsftime - Zeitumwandlung in Wide-Character-Zeichenkette

SYNTAX
     #include <wchar.h>

     sizet wcsftime(wchart *wcs, sizet maxsize, const wchart *format,
                        const struct tm *timptr);

BESCHREIBUNG
     Die Funktion wcsftime() legt Wide-Character-Werte in dem Feld ab, auf
     das wcs zeigt. Die Steuerung erfolgt durch die Zeichenkette, auf die
     format zeigt.

     Das Verhalten dieser Funktion ist so, als ob die durch die Funktion
     strftime() generierte Zeichenkette an die Funktion mbstowcs() als das
     Zeichenketten-Argument übergeben wird. Die Funktion mbstowcs() legt
     das Ergebnis im Argument Zeichenkette aus Wide-Character-Werten der
     Funktion wcsftime() ab (bis zu maxsize Wide-Character-Werte).

     Wenn sich überlappende Objekte ineinander kopiert werden, ist das Ver-
     halten nicht definiert.

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

     ENOSYS    Die Funktion wird nicht unterstützt.

ERGEBNIS
     Wenn die Gesamtzahl der aus der Funktion resultierenden Wide-Charac-
     ter-Werte (einschließlich abschließendem Nullbyte) nicht mehr als
     maxsize beträgt, gibt die Funktion wcsftime() die Anzahl der Wide-
     Character-Werte zurück, die in dem durch wcs angegebenen Feld abgelegt
     wurden (dies schließt das abschließende Nullbyte nicht ein). Andern-
     falls wird Null zurückgegeben. Der Inhalt des Feldes ist dann nicht
     definiert. Wenn die Funktion nicht implementiert ist, wird errno ent-
     sprechend gesetzt.

SIEHE AUCH
     mbstowcs(3C), strftime(3C), LCTIME(4), wchar(5).
















Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98