CKTIS / C
mbrtoc32 — função de conversão Unicode C23
`mbrtoc32(pc32, s, n, ps)` de `<uchar.h>` converte no máximo `n` bytes do próximo caráter multibyte de execução numa unidade UTF-32 `char32_t`. O estado `mbstate_t` permite continuar um caráter dividido entre buffers; um `pc32` nulo ainda converte, mas não guarda.
Versão: C23
Sintaxe
size_t mbrtoc32(char32_t * restrict pc32, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc32(pc32, s, n, ps) de <uchar.h> converte no máximo n bytes do próximo caráter multibyte de execução numa unidade UTF-32 char32_t. O estado mbstate_t permite continuar um caráter dividido entre buffers; um pc32 nulo ainda converte, mas não guarda.
O exemplo passa um estado inicializado a zero e o texto "Z" de um byte. mbrtoc32 devolve a contagem de bytes consumidos 1, guarda U+0000005A e a saída completa é 1 U+0000005A.
O retorno 0 indica caráter nulo e reposição do estado inicial; -2 pede mais bytes, -1 significa EILSEQ e deixa o estado não especificado, enquanto -3 pode fornecer outro resultado do caráter anterior sem consumir entrada. Após -2, continua com os bytes restantes e o mesmo ps; após -3, não avances a entrada. Quando s == NULL, a chamada equivale exatamente a mbrtoc32(NULL, "", 1, ps); pc32 e n são ignorados. É a chamada especificada com texto vazio no estado de conversão atual, não uma promessa de reposição incondicional. Com s não nulo, pc32 == NULL apenas omite a escrita; um ps explícito evita estado interno sem garantia contra races.
Exemplos
#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;}
Resultado
1 U+0000005A
O exemplo passa um estado inicializado a zero e o texto `"Z"` de um byte. `mbrtoc32` devolve a contagem de bytes consumidos `1`, guarda `U+0000005A` e a saída completa é `1 U+0000005A`.