Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

mbrtowc — ponovljiva večbajtna pretvorba C23

`mbrtowc(pwc, s, n, ps)` iz `<wchar.h>` pregleda največ `n` bajtov naslednjega večbajtnega znaka v trenutnem izvedbenem kodiranju. Ko dokonča veljaven znak, vrne število bajtov, ki so ga dokončali, in pri `pwc != NULL` shrani ustrezni `wchar_t`; stanje `mbstate_t`, označeno s `ps`, nadaljuje znak čez meje medpomnilnikov.

Različica: C23

Sintaksa

size_t mbrtowc(wchar_t * restrict pwc, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtowc(pwc, s, n, ps) iz <wchar.h> pregleda največ n bajtov naslednjega večbajtnega znaka v trenutnem izvedbenem kodiranju. Ko dokonča veljaven znak, vrne število bajtov, ki so ga dokončali, in pri pwc != NULL shrani ustrezni wchar_t; stanje mbstate_t, označeno s ps, nadaljuje znak čez meje medpomnilnikov.

Primer izbere zagotovljeno področno nastavitev "C", izrecno ničelno inicializira stanje in dejansko pretvori enobajtni "A". Izhod 1 0041 1 potrdi en porabljen bajt, vrednost širokega znaka in po mbsinit vrnitev v začetno stanje.

0 pomeni široki ničelni znak in začetno stanje, (size_t)-2 nepopoln, a morda veljaven znak brez shranitve in (size_t)-1 napako z errno == EILSEQ, brez shranitve in z nedoločenim stanjem. Po -2 podajte naslednje bajte z istim ps; po -1 stanje pred nadaljevanjem znova inicializirajte. s == NULL je natančno enakovreden mbrtowc(NULL, "", 1, ps), ps == NULL izbere notranje stanje brez jamstva pred podatkovnimi tekmami, wchar_t pa ni nujno točka Unicode. Ko je s == NULL, se vrednosti pwc in n, ki ju poda klicatelj, prezreta.

Primeri

#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;}

Rezultat

1 0041 1

Primer izbere zagotovljeno področno nastavitev `"C"`, izrecno ničelno inicializira stanje in dejansko pretvori enobajtni `"A"`. Izhod `1 0041 1` potrdi en porabljen bajt, vrednost širokega znaka in po `mbsinit` vrnitev v začetno stanje.

Viri