Provided by:
manpages-es_1.55-10_all 
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.