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

CKTIS / C

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

`mbrtoc16(pc16, s, n, ps)` de `<uchar.h>` examina no máximo `n` bytes do próximo caráter multibyte de execução e guarda a unidade UTF-16 `char16_t` correspondente. O objeto `mbstate_t` apontado por `ps` mantém o estado entre chamadas; `pc16 == NULL` apenas omite a escrita.

Versão: C23

Sintaxe

size_t mbrtoc16(char16_t * restrict pc16, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtoc16(pc16, s, n, ps) de <uchar.h> examina no máximo n bytes do próximo caráter multibyte de execução e guarda a unidade UTF-16 char16_t correspondente. O objeto mbstate_t apontado por ps mantém o estado entre chamadas; pc16 == NULL apenas omite a escrita.

O exemplo usa um estado explicitamente inicializado a zero e converte "A", de um byte. A função consome um byte, guarda U+0041 e o programa imprime 1 U+0041; verifica assim o retorno real e a unidade UTF-16.

O resultado 0 indica caráter nulo e estado inicial, -2 um caráter incompleto mas potencialmente válido e -1 um erro de codificação com errno == EILSEQ e estado não especificado. Fora do BMP surge um par substituto: a primeira chamada consome bytes e outra pode devolver -3 e guardar a unidade seguinte sem consumir entrada; não avances então s. Quando s == NULL, a chamada equivale exatamente a mbrtoc16(NULL, "", 1, ps); pc16 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, pc16 == 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};char16_t unit=0;size_t count=mbrtoc16(&unit,"A",1,&state);printf("%zu U+%04X\n",count,(unsigned)unit);return 0;}

Resultado

1 U+0041

O exemplo usa um estado explicitamente inicializado a zero e converte `"A"`, de um byte. A função consome um byte, guarda `U+0041` e o programa imprime `1 U+0041`; verifica assim o retorno real e a unidade UTF-16.

Fontes