std:: c8rtomb
|
Definiert im Header
<cuchar>
|
||
|
std::
size_t
c8rtomb
(
char
*
s, char8_t c8,
std::
mbstate_t
*
ps
)
;
|
(seit C++20) | |
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 notwendig sind, um die Multibyte-Zeichendarstellung dieses Codepoints zu speichern (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. Höchstens MB_CUR_MAX Bytes können von dieser Funktion geschrieben werden.
Wenn c8 nicht die letzte UTF-8-Codeeinheit 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
std
::
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 |
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-Darstellung 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, static_cast < std:: 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 |
Siehe auch
|
(C++20)
|
wandelt ein schmalzeichen Multibyte-Zeichen in UTF-8-Kodierung um
(Funktion) |
|
(C++11)
|
wandelt ein UTF-16-Zeichen in schmalzeichen Multibyte-Kodierung um
(Funktion) |
|
C-Dokumentation
für
c8rtomb
|
|