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

NOMBRE

       mbstowcs  -  convierte una cadena multibyte en una cadena de caracteres
       anchos

SINOPSIS

       #include <stdlib.h>

       size_t mbstowcs (wchar_t *dest, const char *src, size_t n);

DESCRIPCI'ON

       Si dest no es un puntero NULL, la funcion mbstowcs convierte la  cadena
       multibyte  src  a una cadena de caracteres anchos que comienza en dest.
       Como mucho, se escriben n caracteres  anchos  en  dest.  La  conversion
       comienza  en el estado inicial. La conversion se puede detener por tres
       razones:

       1. Se ha encontrado una secuencia multibyte invalida. Es este caso,  la
       funcion devuelve (size_t)(-1).

       2. Se han almacenado n caracteres anchos distintos de L'\0' en dest. En
       este caso, se devuelve el numero de caracteres anchos escritos en dest,
       aunque el estado de cambios, en este punto, se pierde.

       3. Se ha convertido toda la cadena multibyte, incluyendo el '\0' que la
       termina. En esta caso, se  devuelve  el  numero  de  caracteres  anchos
       escritos en dest, excluyendo el caracter L'\0' terminador.

       El  programador debe asegurar que hay espacio en dest para, al menos, n
       caracters anchos.

       Si dest es NULL, n se ignora, y la conversion procede como antes, salvo
       que  los caracteres anchos obtenidos no se escriben en memoria y que no
       hay limite de longitud.

       Para evitar el caso 2 anterior, el programador  deberia  asegurarse  de
       que n es mayor o igual que mbstowcs(NULL,src,0)+1.

VALOR DEVUELTO

       La  funcion  mbstowcs  devuelve  el  numero  de  caracteres  anchos que
       componen la parte convertida de la cadena  de  caracteres  anchos,  sin
       incluir  el  caracter  ancho  nulo  terminador.  Si  se  encuentra  una
       secuencia multibyte invalida, devuelve (size_t)(-1).

CONFORME A

        ISO/ANSI C, UNIX98

V'EASE TAMBI'EN

       mbsrtowcs(3)

OBSERVACIONES

       El comportamiento de mbstowcs depende de la categoria  LC_CTYPE  de  la
       localizacion actual.

       La  funcion  mbsrtowcs  proporciona  una  interfaz  mejor  con la misma
       funcionalidad.