wcrtomb(3) Library Functions Manual wcrtomb(3) BEZEICHNUNG wcrtomb - Ein weites Zeichen in eine Multibyte-Sequenz umwandeln BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include size_t wcrtomb(char *restrict z, wchar_t wz, mbstate_t *restrict ps); BESCHREIBUNG Der Haupteinsatzfall fur diese Funktion liegt vor, wenn z nicht NULL ist und wz kein weites Null-Zeichen ist (L'\0'). In diesem Fall wandelt die Funktion wcrtomb() das weite Zeichen wz in seine Multibyte-Darstellung um und speichert sie am Anfang des Zeichenfeldes, auf das z zeigt. Es aktualisiert den Schiebezustand *ps und liefert die Lange der besagten Multibyte-Darstellung zuruck, das bedeutet, die an z geschriebene Anzahl an Bytes. Ein anderer Fall liegt vor, wenn z nicht NULL ist aber wz ein weites Null-Zeichen ist (L'\0'). In diesem Fall speichert die Funktion wcrtomb() die Schiebesequenz, die benotigt wird, um *ps in seinen anfanglichen Zustand im Zeichenfeld zuruckzubringen, auf das z zeigt, gefolgt von einem >>\0<<-Byte. Es aktualisiert den Schiebezustand (d.h. bringt ihn in den anfanglichen Zustand) und liefert die Lange der Schiebesequenz plus eins zuruck, das bedeutet, die an z geschriebene Anzahl an Bytes. Ein dritter Fall ist, wenn z NULL ist. In diesem Fall wird wz ignoriert und die Funktion liefert letztendlich wcrtomb(buf, L'\0', ps) zuruck, wobei buf ein interner anonymer Puffer ist. Falls ps NULL ist wird stattdessen in allen obigen Fallen ein statischer, anonymer Zustand, der nur der Funktion wcrtomb() bekannt ist, verwandt. RUCKGABEWERT Die Funktion wcrtomb() liefert die Anzahl der Byte zuruck, die in das Byte-Feld unter z geschrieben worden oder worden waren. Falls wz nicht als Multibyte-Sequenz dargestellt werden kann (entsprechend der aktuellen Locale), dann wird (size_t) -1 zuruckgeliefert und errno auf EILSEQ gesetzt. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +-------------+-------------------------+------------------------------+ |Schnittstelle| Attribut | Wert | +-------------+-------------------------+------------------------------+ |wcrtomb() | Multithread-Fahigkeit | MT-Unsicher race:wcrtomb/!ps | +-------------+-------------------------+------------------------------+ STANDARDS C11, POSIX.1-2008. GESCHICHTE POSIX.1-2001, C99. ANMERKUNGEN Das Verhalten von wcrtomb() hangt von der Kategorie LC_CTYPE der aktuellen Locale ab. Die Ubergabe von NULL als ps ist nicht Multithread-sicher. SIEHE AUCH mbsinit(3), wcsrtombs(3) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.12 23. Juli 2024 wcrtomb(3)