.\" -*- 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 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH wcsnrtombs 3 "17. November 2024" "Linux man\-pages 6.12" .SH BEZEICHNUNG wcsnrtombs \- Eine Zeichenkette weiter Zeichen in eine Multibyte\-Zeichenkette umwandeln .SH BIBLIOTHEK Standard\-C\-Bibliothek (\fIlibc\fP,\ \fI\-lc\fP) .SH ÜBERSICHT .nf \fB#include \fP .P \fBsize_t wcsnrtombs(char \fP\fIZiel\fP\fB[restrict .\fP\fIGröße\fP\fB], const wchar_t **restrict \fP\fIQuelle\fP\fB,\fP \fB size_t \fP\fIawz\fP\fB, size_t \fP\fIGröße\fP\fB, mbstate_t *restrict \fP\fIps\fP\fB);\fP .fi .P .RS -4 Mit Glibc erforderliche Feature\-Test\-Makros (siehe \fBfeature_test_macros\fP(7)): .RE .P \fBwcsnrtombs\fP(): .nf Seit Glibc 2.10: _POSIX_C_SOURCE >= 200809L Vor Glibc 2.10: _GNU_SOURCE .fi .SH BESCHREIBUNG Die Funktion \fBwcsnrtombs\fP() ist ähnlich der Funktion \fBwcsrtombs\fP(3), außer dass die Anzahl der umzuwandelnden weiten Zeichen, beginnend bei \fI*Quelle\fP, auf \fIawz\fP begrenzt ist. .P Falls \fIZiel\fP nicht NULL ist, wandelt die Funktion \fBwcsnrtombs\fP() höchstens \fIawz\fP weite Zeichen aus der Zeichenkette weiter Zeichen \fI*Quelle\fP in eine bei \fIZiel\fP beginnende Multibyte\-Sequenz um. Es werden höchstens \fIGröße\fP byte nach \fIZiel\fP geschrieben. Der Schiebezustand \fI*ps\fP wird aktualisiert. Die Umwandlung wird letztendlich durch wiederholten Aufruf von \fIwcrtomb(Ziel, *Quelle, ps)\fP durchgeführt, so lange dieser Aufruf erfolgreich ist und der Erhöhung von \fIZiel\fP um die Anzahl der geschriebenen Byte und \fI*Quelle\fP um eins. Die Umwandlung kann aus drei Gründen stoppen: .IP \[bu] 3 Es wurde ein weites Zeichen angetroffen, das (gemäß der aktuellen Locale) nicht als Multibyte\-Sequenz dargestellt werden kann. In diesem Fall verbleibt \fI*Quelle\fP auf das ungültige Zeichen zeigend, \fI(size_t)\ \-1\fP wird zurückgeliefert und \fIerrno\fP wird auf \fBEILSEQ\fP gesetzt. .IP \[bu] Es wurden \fIawz\fP weite Zeichen umgewandelt, ohne dass ein weites Nullzeichen (L\[aq]\[rs]0\[aq]) angetroffen wurde oder die Größenbeschränkung erzwingt einen Stopp. In diesem Fall zeigt \fI*Quelle\fP weiterhin auf das nächste umzuwandelnde weite Zeichen und die Anzahl der nach \fIZiel\fP geschriebenen Byte wird zurückgeliefert. .IP \[bu] Die Zeichenkette weiter Zeichen wurde komplett umgewandelt, einschließlich des abschließenden weiten Null\-Zeichens (dies hat den Seiteneffekt, dass \fI*ps\fP wieder in seinen ursprünglichen Zustand zurückkehrt). In diesem Fall wird \fI*Quelle\fP auf NULL gesetzt und die Anzahl der nach \fIZiel\fP geschriebenen Byte, ohne das abschließende Null\-Byte (»\[rs]0«), wird zurückgeliefert. .P Falls \fIZiel\fP NULL ist, dann wird \fIGröße\fP ignoriert und die Umwandlung fährt wie oben fort, außer dass die umgewandelten Bytes nicht in den Speicher rausgeschrieben werden und dass keine Zielgrößenbeschränkung existiert. .P Falls \fIps\fP NULL ist, wird in beiden obigen Fällen ein statischer anonymer Zustand, den nur die Funktion \fBwcsnrtombs\fP() kennt, stattdessen verwandt. .P Der Programmierer muss sicherstellen, dass es Raum für mindestens \fIGröße\fP Byte bei \fIZiel\fP gibt. .SH RÜCKGABEWERT Die Funktion \fBwcsnrtombs\fP() liefert die Anzahl an Byte, die den umgewandelten Anteil einer Multibyte\-Sequenz darstellen, ohne das abschließende Null\-Byte. Falls ein weites Zeichen angetroffen wurde, das nicht umgewandelt werden konnte, 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; lb lb lbx l l l. Schnittstelle Attribut Wert T{ .na .nh \fBwcsnrtombs\fP() T} Multithread\-Fähigkeit T{ .na .nh MT\-Unsicher race:wcsnrtombs/!ps T} .TE .SH STANDARDS POSIX.1\-2008. .SH ANMERKUNGEN Das Verhalten von \fBwcsnrtombs\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" \fBiconv\fP(3), \fBmbsinit\fP(3), \fBwcsrtombs\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 .