c8rtomb

Definiert in Header <uchar.h>
size_t c8rtomb ( char * restrict s, char8_t c8, mbstate_t * restrict ps ) ;		(seit C23)

Konvertiert einen einzelnen Codepunkt von UTF-8 in eine schmale Multibyte-Zeichendarstellung.

Wenn s kein Nullzeiger ist und c8 die letzte Codeeinheit in einer gültigen UTF-8-Kodierung eines Codepoints ist, bestimmt die Funktion die Anzahl der Bytes, die zur Speicherung der Multibyte-Zeichendarstellung dieses Codepoints erforderlich sind (einschließlich aller Shift-Sequenzen und unter Berücksichtigung des aktuellen Multibyte-Konvertierungszustands * ps ), und speichert die Multibyte-Zeichendarstellung im Zeichenarray, dessen erstes Element durch s gezeigt wird, wobei * ps bei Bedarf aktualisiert wird. Diese Funktion kann maximal MB_CUR_MAX Bytes schreiben.

Wenn c8 nicht das letzte UTF-8-Codeelement in einer Darstellung eines Codepoints ist, schreibt die Funktion nicht in das Array, auf das s zeigt, nur * ps wird aktualisiert.

Wenn s ein Nullzeiger ist, entspricht der Aufruf c8rtomb ( buf, u8 ' \0 ' , ps ) für einen internen Puffer buf .

Wenn c8 das Nullzeichen u8 ' \0 ' ist, wird ein Nullbyte gespeichert, vorangestellt von jeder Shift-Sequenz, die notwendig ist, um den initialen Shift-Zustand wiederherzustellen, und der Konvertierungszustandsparameter * ps wird aktualisiert, um den initialen Shift-Zustand darzustellen.

Die von dieser Funktion verwendete Multibyte-Kodierung wird durch das aktuell aktive C-Locale festgelegt.

Inhaltsverzeichnis 1 Parameter 2 Rückgabewert 3 Anmerkungen 4 Beispiel 5 Referenzen 6 Siehe auch

Parameter

s	-	Zeiger auf ein schmales Zeichenarray, in dem das Multibyte-Zeichen gespeichert wird
c8	-	die zu konvertierende UTF-8-Codeeinheit
ps	-	Zeiger auf das Konvertierungszustandsobjekt, das bei der Interpretation der Multibyte-Zeichenkette verwendet wird

Rückgabewert

Die Anzahl der Bytes, die im Array-Objekt gespeichert sind (einschließlich aller Shift-Sequenzen). Dies kann null sein, wenn c8 nicht die letzte Codeeinheit in der UTF-8-Repräsentation eines Codepunkts ist.

Wenn c8 ungültig ist (nicht zu einer Sequenz von char8_t beiträgt, die einem gültigen Multibyte-Zeichen entspricht), wird der Wert des Makros EILSEQ in errno gespeichert, ( size_t ) - 1 wird zurückgegeben und der Konvertierungszustand ist nicht spezifiziert.

Hinweise

Aufrufe von c8rtomb mit einem Nullzeiger-Argument für s können einen Datenwettlauf mit anderen Aufrufen von c8rtomb mit einem Nullzeiger-Argument für s verursachen.

Beispiel

Dieser Abschnitt ist unvollständig Grund: Kein Beispiel

Referenzen

Siehe auch

mbrtoc8 (C23)	wandelt ein schmales Multibyte-Zeichen in UTF-8-Kodierung um (Funktion)
C++-Dokumentation für c8rtomb