.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH wcrtomb 3 "23. Juli 2024" "Linux man\-pages 6.12" 
.SH BEZEICHNUNG
wcrtomb \- Ein weites Zeichen in eine Multibyte\-Sequenz umwandeln
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP,\ \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#include <wchar.h>\fP
.P
\fBsize_t wcrtomb(char *restrict \fP\fIz\fP\fB, wchar_t \fP\fIwz\fP\fB, mbstate_t *restrict \fP\fIps\fP\fB);\fP
.fi
.SH BESCHREIBUNG
Der Haupteinsatzfall für diese Funktion liegt vor, wenn \fIz\fP nicht NULL ist
und \fIwz\fP kein weites Null\-Zeichen ist (L\[aq]\[rs]0\[aq]). In diesem Fall
wandelt die Funktion \fBwcrtomb\fP() das weite Zeichen \fIwz\fP in seine
Multibyte\-Darstellung um und speichert sie am Anfang des Zeichenfeldes, auf
das \fIz\fP zeigt. Es aktualisiert den Schiebezustand \fI*ps\fP und liefert die
Länge der besagten Multibyte\-Darstellung zurück, das bedeutet, die an \fIz\fP
geschriebene Anzahl an Bytes.
.P
Ein anderer Fall liegt vor, wenn \fIz\fP nicht NULL ist aber \fIwz\fP ein weites
Null\-Zeichen ist (L\[aq]\[rs]0\[aq]). In diesem Fall speichert die Funktion
\fBwcrtomb\fP() die Schiebesequenz, die benötigt wird, um \fI*ps\fP in seinen
anfänglichen Zustand im Zeichenfeld zurückzubringen, auf das \fIz\fP zeigt,
gefolgt von einem »\[rs]0«\-Byte. Es aktualisiert den Schiebezustand
(d.h. bringt ihn in den anfänglichen Zustand) und liefert die Länge der
Schiebesequenz plus eins zurück, das bedeutet, die an \fIz\fP geschriebene
Anzahl an Bytes.
.P
Ein dritter Fall ist, wenn \fIz\fP NULL ist. In diesem Fall wird \fIwz\fP
ignoriert und die Funktion liefert letztendlich
.P
.in +4n
.EX
wcrtomb(buf, L\[aq]\[rs]0\[aq], ps)
.EE
.in
.P
zurück, wobei \fIbuf\fP ein interner anonymer Puffer ist.
.P
Falls \fIps\fP NULL ist wird stattdessen in allen obigen Fällen ein statischer,
anonymer Zustand, der nur der Funktion \fBwcrtomb\fP() bekannt ist, verwandt.
.SH RÜCKGABEWERT
Die Funktion \fBwcrtomb\fP() liefert die Anzahl der Byte zurück, die in das
Byte\-Feld unter \fIz\fP geschrieben worden oder worden wären. Falls \fIwz\fP nicht
als Multibyte\-Sequenz dargestellt werden kann (entsprechend der aktuellen
Locale), dann wird \fI(size_t)\ \-1\fP zurückgeliefert und \fIerrno\fP auf
\fBEILSEQ\fP gesetzt.
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lbx lb lb
l l l.
Schnittstelle	Attribut	Wert
T{
.na
.nh
\fBwcrtomb\fP()
T}	Multithread\-Fähigkeit	MT\-Unsicher race:wcrtomb/!ps
.TE
.SH STANDARDS
C11, POSIX.1\-2008.
.SH GESCHICHTE
POSIX.1\-2001, C99.
.SH ANMERKUNGEN
Das Verhalten von \fBwcrtomb\fP() hängt von der Kategorie \fBLC_CTYPE\fP der
aktuellen Locale ab.
.P
Die Übergabe von NULL als \fIps\fP ist nicht Multithread\-sicher.
.SH "SIEHE AUCH"
\fBmbsinit\fP(3), \fBwcsrtombs\fP(3)
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .