Provided by: manpages-es_1.55-10_all bug

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.