.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, Bruno Haible <bruno@clisp.org>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH wctomb 3 "8. Februar 2026" "Linux man\-pages 6.18" 
.SH BEZEICHNUNG
wctomb \- Konvertiert ein weites Zeichen in eine Multibyte\-Sequenz
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP,\ \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#include <stdlib.h>\fP
.P
\fBint wctomb(char *\fP\fIz\fP\fB, wchar_t \fP\fIwz\fP\fB);\fP
.fi
.SH BESCHREIBUNG
Falls \fIz\fP nicht NULL ist, konvertiert die Funktion \fBwctomb\fP() das weite
Zeichen \fIwz\fP in seine Multibyte\-Darstellung und speichert sie am Anfang des
Zeichenfeldes, auf das \fIz\fP zeigt. Sie aktualisiert den Verschiebe\-Zustand,
der in einer statischen anonymen Variable gespeichert wird, die nur der
Funktion \fBwctomb\fP() bekannt ist, und liefert die Länge der besagten
Multibyte\-Darstellung zurück, d.h. die Anzahl der nach \fIz\fP geschriebenen
Byte.
.P
Höchstens \fBMB_CUR_MAX\fP byte werden nach \fIz\fP geschrieben. Der Programmierer
muss sicherstellen, dass es genug Raum gibt, um die Multibyte\-Sequenz unter
\fIz\fP zu schreiben.
.P
.\" The Dinkumware doc and the Single UNIX specification say this, but
.\" glibc doesn't implement this.
Falls \fIz\fP NULL ist, setzt \fBwctomb\fP() den nur dieser Funktion bekannten
Schiebe\-Zustand auf den anfänglichen Zustand zurück und liefert einen von
Null verschiedenen Wert zurück, falls die Kodierung einen nicht trivialen
Schiebe\-Zustand hat oder Null, falls die Kodierung zustandsfrei ist.
.SH RÜCKGABEWERT
Falls \fIz\fP nicht NULL ist, dann liefert \fBwctomb\fP() die Anzahl der in das
Byte\-Feld unter \fIz\fP geschriebenen Byte zurück. Falls \fIwz\fP nicht als
Multibyte\-Sequenz (gemäß der aktuellen Locale) dargestellt werden kann, wird
\-1 zurückgeliefert.
.P
Falls \fIz\fP NULL ist, liefert \fBwctomb\fP() einen von Null verschiedenen Wert
zurück, falls die Kodierung einen nicht trivialen Schiebe\-Zustand hat oder
Null, falls die Kodierung zustandsfrei ist.
.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
\fBwctomb\fP()
T}	Multithread\-Fähigkeit	MT\-Unsicher race
.TE
.SH VERSIONEN
Die Funktion \fBwcrtomb\fP(3) stellt eine bessere Schnittstelle für die gleiche
Funktionalität bereit.
.SH STANDARDS
C11, POSIX.1\-2008.
.SH GESCHICHTE
POSIX.1\-2001, C99.
.SH ANMERKUNGEN
Das Verhalten von \fBwctomb\fP() hängt von der Kategorie \fBLC_CTYPE\fP der
aktuellen Locale ab.
.SH "SIEHE AUCH"
\fBMB_CUR_MAX\fP(3), \fBmblen\fP(3), \fBmbstowcs\fP(3), \fBmbtowc\fP(3), \fBwcrtomb\fP(3),
\fBwcstombs\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 .