.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) Bruno Haible .\" .\" 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 wcstombs 3 "31. Oktober 2023" "Linux man\-pages 6.06" .SH BEZEICHNUNG wcstombs \- Eine Zeichenkette weiter Zeichen in eine Multibyte\-Zeichenkette konvertieren .SH BIBLIOTHEK Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP) .SH ÜBERSICHT .nf \fB#include \fP .P \fBsize_t wcstombs(char \fP\fIZiel\fP\fB[restrict .\fP\fIn\fP\fB], const wchar_t *restrict \fP\fIQuelle\fP\fB,\fP \fB size_t \fP\fIn\fP\fB);\fP .fi .SH BESCHREIBUNG Falls \fIZiel\fP nicht NULL ist, konvertiert die Funktion \fBwcstombs\fP() die Zeichenkette weiter Zeichen \fIQuelle\fP in eine bei \fIZiel\fP beginnende Multibyte\-Zeichenkette. Es werden nach \fIZiel\fP höchstens \fIn\fP byte geschrieben. Die in \fIZiel\fP abgelegte Zeichensequenz beginnt im anfänglichen Schiebe\-Zustand. Die Konvertierung kann aus drei Gründen stoppen: .IP \[bu] 3 Es wurde auf ein weites Zeichen gestossen, das nicht als Multibyte\-Sequenz dargestellt werden kann (gemäß der aktuellen Locale). In diesem Fall wird \fI(size_t)\ \-1\fP zurückgeliefert. .IP \[bu] Die Längenbegrenzung erzwingt einen Stopp. In diesem Fall wird die Anzahl der nach \fIZiel\fP geschriebenen Bytes zurückgeliefert, aber der Schiebe\-Zustand geht an diesem Punkt verloren. .IP \[bu] Die Zeichenkette weiter Zeichen wurde vollständig umgewandelt, einschließlich des abschließenden weiten Nullzeichens (L\[aq]\e0\[aq]). In diesem Fall endet die Umwandlung im anfänglichen Schiebe\-Zustand. Es wird die Anzahl der nach \fIZiel\fP geschriebenen Bytes ohne das abschließende Nullbyte (»\e0«) zurückgeliefert. .P Der Programmierer muss sicherstellen, dass bei \fIZiel\fP Platz für mindestens \fIn\fP byte ist. .P Falls \fIZiel\fP NULL ist, wird \fIn\fP ignoriert und die Umwandlung fährt wie oben fort, außer dass die umgewandelten Bytes nicht in den Speicher geschrieben werden und keine Längenbeschränkung existiert. .P Um den obigen zweiten Fall zu vermeiden, sollte der Programmierer sicherstellen, dass \fIn\fP größer oder gleich \fIwcstombs(NULL,Quelle,0)+1\fP ist. .SH RÜCKGABEWERT Die Funktion \fBwcstombs\fP() liefert die Anzahl der Bytes zurück, die den umgewandelten Teil der Multibyte\-Sequenz darstellen, ohne das abschließende Nullbyte. Falls ein weites Zeichen angetroffen wurde, das nicht umgewandelt werden konnte, wird \fI(size_t)\ \-1\fP zurückgeliefert. .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 \fBwcstombs\fP() T} Multithread\-Fähigkeit MT\-Sicher .TE .SH VERSIONEN Die Funktion \fBwcsrtombs\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 \fBwcstombs\fP() hängt von der Kategorie \fBLC_CTYPE\fP der aktuellen Locale ab. .SH "SIEHE AUCH" \fBmblen\fP(3), \fBmbstowcs\fP(3), \fBmbtowc\fP(3), \fBwcsrtombs\fP(3), \fBwctomb\fP(3) .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann 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 .