CKTIS / C
mbrtowc — restartierbare C23-Multibyte-Konvertierung
`mbrtowc(pwc, s, n, ps)` aus `<wchar.h>` untersucht höchstens `n` Bytes des nächsten Multibytezeichens in der aktuellen Ausführungscodierung. Wird ein gültiges Zeichen abgeschlossen, liefert die Funktion die Zahl der dazu benötigten Bytes und speichert bei `pwc != NULL` den entsprechenden `wchar_t`; der `mbstate_t` bei `ps` führt ein über Puffergrenzen geteiltes Zeichen fort.
Version: C23
Syntax
size_t mbrtowc(wchar_t * restrict pwc, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtowc(pwc, s, n, ps) aus <wchar.h> untersucht höchstens n Bytes des nächsten Multibytezeichens in der aktuellen Ausführungscodierung. Wird ein gültiges Zeichen abgeschlossen, liefert die Funktion die Zahl der dazu benötigten Bytes und speichert bei pwc != NULL den entsprechenden wchar_t; der mbstate_t bei ps führt ein über Puffergrenzen geteiltes Zeichen fort.
Das Beispiel wählt das garantierte Locale "C", initialisiert eigenen Zustand mit null und konvertiert wirklich das einbyteige "A". Ausgabe 1 0041 1 bestätigt ein verbrauchtes Byte, den Wert des breiten Zeichens und laut mbsinit die Rückkehr in den Anfangszustand.
0 bezeichnet das breite Nullzeichen und Anfangszustand, (size_t)-2 ein unvollständiges, aber potenziell gültiges Zeichen ohne Speicherung und (size_t)-1 einen Codierungsfehler mit errno == EILSEQ, ohne Speicherung und mit unbestimmtem Zustand. Nach -2 weitere Bytes mit demselben ps liefern; nach -1 nur nach Neuinitialisierung fortfahren. s == NULL entspricht exakt mbrtowc(NULL, "", 1, ps), ps == NULL wählt internen Zustand, dessen Freiheit von Data Races nicht gefordert ist, und wchar_t muss kein Unicode-Codepunkt sein. Bei s == NULL werden die vom Aufrufer übergebenen Werte pwc und n ignoriert.
Beispiele
#include <locale.h>
#include <stdio.h>
#include <wchar.h>
int main(void){setlocale(LC_CTYPE,"C");mbstate_t state={0};wchar_t wc=0;size_t n=mbrtowc(&wc,"A",1,&state);printf("%zu %04lX %d\n",n,(unsigned long)wc,mbsinit(&state)!=0);return 0;}
Ergebnis
1 0041 1
Das Beispiel wählt das garantierte Locale `"C"`, initialisiert eigenen Zustand mit null und konvertiert wirklich das einbyteige `"A"`. Ausgabe `1 0041 1` bestätigt ein verbrauchtes Byte, den Wert des breiten Zeichens und laut `mbsinit` die Rückkehr in den Anfangszustand.