Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

mbrtoc16 — función de conversión Unicode de C23

`mbrtoc16(pc16, s, n, ps)` de `<uchar.h>` examina como máximo `n` bytes del siguiente carácter multibyte de ejecución y guarda la unidad `char16_t` UTF-16 correspondiente. El objeto `mbstate_t` señalado por `ps` conserva el estado entre llamadas; `pc16 == NULL` solo omite el almacenamiento.

Versión: C23

Sintaxis

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 como máximo n bytes del siguiente carácter multibyte de ejecución y guarda la unidad char16_t UTF-16 correspondiente. El objeto mbstate_t señalado por ps conserva el estado entre llamadas; pc16 == NULL solo omite el almacenamiento.

El ejemplo usa un estado inicializado explícitamente a cero y convierte el "A" de un byte. La función consume un byte, guarda U+0041 y el programa imprime 1 U+0041; así comprueba el retorno real y la unidad UTF-16.

El resultado 0 indica carácter nulo y estado inicial, -2 un carácter incompleto pero potencialmente válido y -1 un error de codificación con errno == EILSEQ y estado no especificado. Fuera del BMP se produce un par sustituto: la primera llamada consume bytes y otra puede devolver -3 y guardar la siguiente unidad sin consumir entrada; no avances entonces s. Cuando s == NULL, la llamada equivale exactamente a mbrtoc16(NULL, "", 1, ps); se ignoran pc16 y n. Es la llamada especificada con cadena vacía en el estado de conversión actual, no una promesa de reinicio incondicional. Con s no nulo, pc16 == NULL solo omite guardar; un ps explícito evita el estado interno sin garantía contra data races.

Ejemplos

#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

El ejemplo usa un estado inicializado explícitamente a cero y convierte el `"A"` de un byte. La función consume un byte, guarda `U+0041` y el programa imprime `1 U+0041`; así comprueba el retorno real y la unidad UTF-16.

Fuentes