CKTIS / C
mbrtowc — C23-herstartbare multibyteconversie
`mbrtowc(pwc, s, n, ps)` uit `<wchar.h>` onderzoekt hoogstens `n` bytes van het volgende multibyte-teken in de huidige uitvoeringscodering. Na voltooiing van een geldig teken retourneert zij het aantal bytes dat het teken voltooide en bewaart bij `pwc != NULL` de overeenkomstige `wchar_t`; de `mbstate_t` bij `ps` zet een teken over buffergrenzen voort.
Versie: 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) uit <wchar.h> onderzoekt hoogstens n bytes van het volgende multibyte-teken in de huidige uitvoeringscodering. Na voltooiing van een geldig teken retourneert zij het aantal bytes dat het teken voltooide en bewaart bij pwc != NULL de overeenkomstige wchar_t; de mbstate_t bij ps zet een teken over buffergrenzen voort.
Het voorbeeld kiest de gegarandeerde locale "C", initialiseert expliciete toestand met nul en converteert werkelijk de één byte lange "A". Uitvoer 1 0041 1 bevestigt één verbruikte byte, de waarde van het brede teken en volgens mbsinit de terugkeer naar begintoestand.
0 betekent het brede nul-teken en begintoestand, (size_t)-2 een onvolledig maar mogelijk geldig teken zonder opslag en (size_t)-1 een coderingsfout met errno == EILSEQ, zonder opslag en met ongespecificeerde toestand. Geef na -2 volgende bytes met dezelfde ps; initialiseer na -1 opnieuw. s == NULL is exact gelijk aan mbrtowc(NULL, "", 1, ps), ps == NULL kiest interne toestand zonder race-vrijgarantie en wchar_t hoeft geen Unicode-codepunt te zijn. Als s == NULL, worden de door de aanroeper geleverde waarden pwc en n genegeerd.
Voorbeelden
#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;}
Resultaat
1 0041 1
Het voorbeeld kiest de gegarandeerde locale `"C"`, initialiseert expliciete toestand met nul en converteert werkelijk de één byte lange `"A"`. Uitvoer `1 0041 1` bevestigt één verbruikte byte, de waarde van het brede teken en volgens `mbsinit` de terugkeer naar begintoestand.