База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

mbrtoc32 — функция за Unicode преобразуване в C23

`mbrtoc32(pc32, s, n, ps)` от `<uchar.h>` преобразува най-много `n` байта от следващия многобайтов знак на изпълнимото кодиране в UTF-32 единица `char32_t`. Състоянието `mbstate_t` позволява знак да продължи през граници на буфери; нулев `pc32` пак преобразува, но не записва.

Версия: C23

Синтаксис

size_t mbrtoc32(char32_t * restrict pc32, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtoc32(pc32, s, n, ps) от <uchar.h> преобразува най-много n байта от следващия многобайтов знак на изпълнимото кодиране в UTF-32 единица char32_t. Състоянието mbstate_t позволява знак да продължи през граници на буфери; нулев pc32 пак преобразува, но не записва.

Примерът подава нулево инициализирано състояние и еднобайтовия низ "Z". mbrtoc32 връща броя консумирани байтове 1, записва U+0000005A, а пълният изход е 1 U+0000005A.

Резултат 0 означава нулев знак и възстановено начално състояние; -2 иска още байтове, -1 означава EILSEQ и оставя състоянието неуточнено, а -3 може да достави следващ резултат от предишния знак без вход. След -2 продължете с оставащите байтове и същия ps; след -3 не местете входа. Когато s == NULL, извикването е точно еквивалентно на mbrtoc32(NULL, "", 1, ps); pc32 и n се игнорират. Това е зададеното извикване с празен низ в текущото състояние на преобразуване, не обещание за безусловен reset. При ненулево s, pc32 == NULL пропуска само записа; собствен ps избягва вътрешно състояние без гаранция срещу data race.

Примери

#include <stdio.h>
#include <uchar.h>
int main(void){mbstate_t state={0};char32_t unit=0;size_t count=mbrtoc32(&unit,"Z",1,&state);printf("%zu U+%08X\n",count,(unsigned)unit);return 0;}

Резултат

1 U+0000005A

Примерът подава нулево инициализирано състояние и еднобайтовия низ `"Z"`. `mbrtoc32` връща броя консумирани байтове `1`, записва `U+0000005A`, а пълният изход е `1 U+0000005A`.

Източници