Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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`.

Fontes