CKTIS / C
mbrtoc8 — función de conversión Unicode de C23
`mbrtoc8(pc8, s, n, ps)` de `<uchar.h>` de C23 convierte el siguiente carácter multibyte de ejecución en unidades UTF-8 `char8_t` sucesivas; en C23, `char8_t` es el mismo tipo que `unsigned char`. Examina como máximo `n` bytes y `mbstate_t` conserva un carácter parcial y unidades pendientes.
Versión: C23
Sintaxis
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> de C23 convierte el siguiente carácter multibyte de ejecución en unidades UTF-8 char8_t sucesivas; en C23, char8_t es el mismo tipo que unsigned char. Examina como máximo n bytes y mbstate_t conserva un carácter parcial y unidades pendientes.
El ejemplo usa estado explícito y llama realmente a mbrtoc8 para el "!" de un byte. La función devuelve 1, guarda la unidad UTF-8 0x21 y la salida 1 21 comprueba ambos efectos. El código necesita una biblioteca C23 que proporcione esta función recién estandarizada.
0 indica carácter nulo y estado inicial, -2 entrada incompleta, -1 error EILSEQ con estado no especificado y -3 almacenamiento de otra unidad UTF-8 del carácter previo sin consumir bytes nuevos. No avances s tras -3; tras -2, pasa los bytes restantes con el mismo ps. Cuando s == NULL, la llamada equivale exactamente a mbrtoc8(NULL, "", 1, ps); se ignoran pc8 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, pc8 == 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};char8_t unit=0;size_t count=mbrtoc8(&unit,"!",1,&state);printf("%zu %02X\n",count,(unsigned)unit);return 0;}
Resultado
1 21
El ejemplo usa estado explícito y llama realmente a `mbrtoc8` para el `"!"` de un byte. La función devuelve `1`, guarda la unidad UTF-8 `0x21` y la salida `1 21` comprueba ambos efectos. El código necesita una biblioteca C23 que proporcione esta función recién estandarizada.