Provided by:
manpages-es_1.55-10_all 
NOMBRE
mbtowc - convierte una secuencia multibyte en un caracter ancho
SINOPSIS
#include <stdlib.h>
int mbtowc (wchar_t *pwc, const char *s, size_t n);
DESCRIPCI'ON
El principal caso para esta funcion se da cuando s no es NULL y pwc no
es NULL. En este caso, la funcion mbtowc inspecciona, como mucho, n
bytes de la cadena multibyte s, extrae el siguiente caracter multibyte
completo, lo convierte a un caracter ancho y lo almacena en *pwc.
Actualiza un estado de cambios interno solo conocido por la funcion
mbtowc. Si s no apunta aun byte '\0', la funcion devuelve el numero de
bytes consumidos de s. En otro caso, devuelve 0.
Si los primeros n bytes de s no contienen un caracter multibyte
completo, o si contiene una secuencia multibyte invalida, mbtowc
devuelve -1. Esto puede ocurrir incluso sif n >= MB_CUR_MAX, si la
cadena multibyte contiene secuencias de cambios redundantes.
Un caso diferente se da cuando s no es NULL pero pwc si lo es. En este
caso, la funcion mbtowc se comporta como antes pero no almacena el
caracter ancho obtenido en memoria.
Un tercer caso se da cuando s es NULL. En este caso, pwc y n se
ignoran. La funcion mbtowc devuelve el estado de cambios, solo conocido
por esta funcion, a su estado inicial y devuelve un valor distinto de
cero si la condificacion posee un estado de cambios no trivial o cero
si es una codificacion sin estado.
VALOR DEVUELTO
Si s no es NULL, la funcion mbtowc devuelve el numero de bytes
consumidos de s, 0 si s apunta a un byte nulo o -1 en caso de fallo.
Si s es NULL, la funcion mbtowc devuelve un valor distinto de cero si
la codificacion posee un estado de cambios no trivial o cero si es una
codificacion sin estado.
CONFORME A
ISO/ANSI C, UNIX98
V'EASE TAMBI'EN
mbrtowc(3), mbstowcs(3), MB_CUR_MAX(3)
OBSERVACIONES
El comportamiento de mbtowc depende de la categoria LC_CTYPE de la
localizacion actual.
Esta funcion no es segura en un entorno multihilos. La funcion mbrtowc
proporciona una interfaz mejor con la misma funcionalidad.