Provided by: manpages-es_1.55-8_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ÓN

       Si dest no es un puntero NULL, la función 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  conversión
       comienza  en el estado inicial. La conversión se puede detener por tres
       razones:

       1. Se ha encontrado una secuencia multibyte inválida. Es este caso,  la
       función devuelve (size_t)(-1).

       2. Se han almacenado n caracteres anchos distintos de L’\0’ en dest. En
       este caso, se devuelve el número 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  número  de  caracteres  anchos
       escritos en dest, excluyendo el carácter 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 conversión procede como antes, salvo
       que  los caracteres anchos obtenidos no se escriben en memoria y que no
       hay límite de longitud.

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

VALOR DEVUELTO

       La  función  mbstowcs  devuelve  el  número  de  caracteres  anchos que
       componen la parte convertida de la cadena  de  caracteres  anchos,  sin
       incluir  el  carácter  ancho  nulo  terminador.  Si  se  encuentra  una
       secuencia multibyte inválida, devuelve (size_t)(-1).

CONFORME A

        ISO/ANSI C, UNIX98

VÉASE TAMBIÉN

       mbsrtowcs(3)

OBSERVACIONES

       El comportamiento de mbstowcs depende de la categoría  LC_CTYPE  de  la
       localización actual.

       La  función  mbsrtowcs  proporciona  una  interfaz  mejor  con la misma
       funcionalidad.