CKTIS / C
mbrtoc16 — C23-Unicode-Konvertierungsfunktion
`mbrtoc16(pc16, s, n, ps)` aus `<uchar.h>` untersucht höchstens `n` Bytes des nächsten Multibytezeichens der Ausführungsumgebung und speichert die entsprechende UTF-16-Einheit vom Typ `char16_t`. Das von `ps` bezeichnete `mbstate_t` erhält den Zustand zwischen Aufrufen; `pc16 == NULL` unterdrückt nur das Speichern.
Version: C23
Syntax
size_t mbrtoc16(char16_t * restrict pc16, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc16(pc16, s, n, ps) aus <uchar.h> untersucht höchstens n Bytes des nächsten Multibytezeichens der Ausführungsumgebung und speichert die entsprechende UTF-16-Einheit vom Typ char16_t. Das von ps bezeichnete mbstate_t erhält den Zustand zwischen Aufrufen; pc16 == NULL unterdrückt nur das Speichern.
Das Beispiel verwendet einen ausdrücklich nullinitialisierten Zustand und konvertiert das einbyteige "A". Die Funktion verbraucht ein Byte, speichert U+0041, und das Programm gibt 1 U+0041 aus; damit prüft es Rückgabewert und UTF-16-Einheit wirklich.
0 bezeichnet das Nullzeichen und den Anfangszustand, -2 ein unvollständiges, aber möglicherweise gültiges Zeichen und -1 einen Kodierungsfehler mit errno == EILSEQ und nicht festgelegtem Zustand. Außerhalb der BMP entsteht ein Surrogatpaar: Der erste Aufruf verbraucht Bytes, ein späterer kann -3 liefern und die nächste Einheit ohne Eingabeverbrauch speichern; dann s nicht vorrücken. Bei s == NULL entspricht der Aufruf exakt mbrtoc16(NULL, "", 1, ps); pc16 und n werden ignoriert. Dies ist der festgelegte Aufruf mit leerer Zeichenfolge im aktuellen Konvertierungszustand, keine Zusage eines bedingungslosen Resets. Bei nicht-null s unterdrückt pc16 == NULL nur das Speichern; eigener ps vermeidet den internen Zustand ohne Race-Freiheitsgarantie.
Beispiele
#include <stdio.h>
#include <uchar.h>
int main(void){mbstate_t state={0};char16_t unit=0;size_t count=mbrtoc16(&unit,"A",1,&state);printf("%zu U+%04X\n",count,(unsigned)unit);return 0;}
Ergebnis
1 U+0041
Das Beispiel verwendet einen ausdrücklich nullinitialisierten Zustand und konvertiert das einbyteige `"A"`. Die Funktion verbraucht ein Byte, speichert `U+0041`, und das Programm gibt `1 U+0041` aus; damit prüft es Rückgabewert und UTF-16-Einheit wirklich.