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

CKTIS / C

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

`mbrtoc32(pc32, s, n, ps)` de `<uchar.h>` convierte como máximo `n` bytes del siguiente carácter multibyte de ejecución en una unidad UTF-32 `char32_t`. Su estado `mbstate_t` permite continuar un carácter dividido entre búferes; un `pc32` nulo aún convierte, pero no guarda.

Versión: C23

Sintaxis

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> convierte como máximo n bytes del siguiente carácter multibyte de ejecución en una unidad UTF-32 char32_t. Su estado mbstate_t permite continuar un carácter dividido entre búferes; un pc32 nulo aún convierte, pero no guarda.

El ejemplo pasa un estado inicializado a cero y la cadena "Z" de un byte. mbrtoc32 devuelve el número de bytes consumidos 1, guarda U+0000005A y la salida completa es 1 U+0000005A.

El retorno 0 indica carácter nulo y vuelta al estado inicial; -2 pide más bytes, -1 significa EILSEQ y deja el estado no especificado, mientras -3 puede entregar otro resultado del carácter previo sin consumir entrada. Tras -2, continúa con los bytes restantes y el mismo ps; tras -3, no avances la entrada. Cuando s == NULL, la llamada equivale exactamente a mbrtoc32(NULL, "", 1, ps); se ignoran pc32 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, pc32 == 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};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

El ejemplo pasa un estado inicializado a cero y la cadena `"Z"` de un byte. `mbrtoc32` devuelve el número de bytes consumidos `1`, guarda `U+0000005A` y la salida completa es `1 U+0000005A`.

Fuentes