CKTIS / C
mbrtowc — conversión multibyte reiniciable de C23
`mbrtowc(pwc, s, n, ps)` de `<wchar.h>` examina como máximo `n` bytes del siguiente carácter multibyte en la codificación de ejecución actual. Al completar un carácter válido devuelve el número de bytes que lo completaron y guarda el `wchar_t` correspondiente si `pwc != NULL`; el `mbstate_t` señalado por `ps` continúa un carácter dividido entre búferes.
Versión: C23
Sintaxis
size_t mbrtowc(wchar_t * restrict pwc, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtowc(pwc, s, n, ps) de <wchar.h> examina como máximo n bytes del siguiente carácter multibyte en la codificación de ejecución actual. Al completar un carácter válido devuelve el número de bytes que lo completaron y guarda el wchar_t correspondiente si pwc != NULL; el mbstate_t señalado por ps continúa un carácter dividido entre búferes.
El ejemplo selecciona la locale garantizada "C", inicializa a cero un estado explícito y convierte realmente el "A" de un byte. La salida 1 0041 1 confirma un byte consumido, el valor del carácter ancho y la vuelta al estado inicial indicada por mbsinit.
El resultado 0 indica carácter ancho nulo y estado inicial, (size_t)-2 un carácter incompleto pero potencialmente válido sin escritura, y (size_t)-1 un error con errno == EILSEQ, sin escritura y con estado no especificado. Tras -2, proporciona bytes siguientes con el mismo ps; tras -1, reinicializa antes de continuar. s == NULL equivale exactamente a mbrtowc(NULL, "", 1, ps), ps == NULL usa estado interno sin garantía contra data races y wchar_t no tiene por qué ser un punto Unicode. Cuando s == NULL, se ignoran los valores pwc y n proporcionados por quien llama.
Ejemplos
#include <locale.h>
#include <stdio.h>
#include <wchar.h>
int main(void){setlocale(LC_CTYPE,"C");mbstate_t state={0};wchar_t wc=0;size_t n=mbrtowc(&wc,"A",1,&state);printf("%zu %04lX %d\n",n,(unsigned long)wc,mbsinit(&state)!=0);return 0;}
Resultado
1 0041 1
El ejemplo selecciona la locale garantizada `"C"`, inicializa a cero un estado explícito y convierte realmente el `"A"` de un byte. La salida `1 0041 1` confirma un byte consumido, el valor del carácter ancho y la vuelta al estado inicial indicada por `mbsinit`.