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

CKTIS / C

mbrtoc8 — função de conversão Unicode C23

`mbrtoc8(pc8, s, n, ps)` de `<uchar.h>` C23 converte o próximo caráter multibyte de execução em unidades UTF-8 `char8_t` sucessivas; em C23, `char8_t` é o mesmo tipo que `unsigned char`. Examina no máximo `n` bytes, enquanto `mbstate_t` retém um caráter parcial e unidades pendentes.

Versão: C23

Sintaxe

size_t mbrtoc8(char8_t * restrict pc8, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtoc8(pc8, s, n, ps) de <uchar.h> C23 converte o próximo caráter multibyte de execução em unidades UTF-8 char8_t sucessivas; em C23, char8_t é o mesmo tipo que unsigned char. Examina no máximo n bytes, enquanto mbstate_t retém um caráter parcial e unidades pendentes.

O exemplo usa estado explícito e chama realmente mbrtoc8 para "!", de um byte. A função devolve 1, guarda a unidade UTF-8 0x21 e a saída 1 21 verifica ambos os efeitos. O código requer uma biblioteca C23 que forneça esta função recém-normalizada.

0 indica caráter nulo e estado inicial, -2 entrada incompleta, -1 erro EILSEQ com estado não especificado e -3 armazenamento de outra unidade UTF-8 do caráter anterior sem consumir novos bytes. Não avances s após -3; após -2, fornece os bytes restantes com o mesmo ps. Quando s == NULL, a chamada equivale exatamente a mbrtoc8(NULL, "", 1, ps); pc8 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, pc8 == 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};char8_t unit=0;size_t count=mbrtoc8(&unit,"!",1,&state);printf("%zu %02X\n",count,(unsigned)unit);return 0;}

Resultado

1 21

O exemplo usa estado explícito e chama realmente `mbrtoc8` para `"!"`, de um byte. A função devolve `1`, guarda a unidade UTF-8 `0x21` e a saída `1 21` verifica ambos os efeitos. O código requer uma biblioteca C23 que forneça esta função recém-normalizada.

Fontes