Provided by:
manpages-es_1.55-10_all 
NOMBRE
wcstombs - convierte una cadena de caracteres anchos a una cadena
mulibyte
SYNOPSIS
#include <stdlib.h>
size_t wcstombs (char *dest, const wchar_t *src, size_t n);
DESCRIPCI'ON
Si dest no es un puntero NULL, la funcion wcstombs convierte la cadena
de caracteres anchos *src en una cadena multibyte comenzando en dest.
En dest se escriben, como mucho, n bytes. El estado de cambios *ps se
acualiza. La conversion comienza en el estado inicial. La conversion
puede pararse por tres razones:
1. Se ha encontrado un caracter ancho que no se puede representar como
una secuencia multibyte (de acuerdo con la localizacion actual). En
este caso se devuelve (size_t)(-1).
2. El limite de longitud fuerza la parada. En este caso, devuelve el
numero de bytes escritos en dest pero el estado de cambios en este
punto se pierde.
3. Se ha completado la conversion de la cadena de caracteres anchos,
incluyendo la terminacion L'\0'. En este caso, la conversion termina en
el estado inicial. Devuelve el numero de bytes escritos en dest,
excluyendo el byte terminador '\0'.
El programador tiene que asegurarse de que hay espacio para al menos n
bytes en dest.
Si dest es NULL, len se ignora, y la conversion procede como arriba,
salvo que los bytes convertidos no se escriben en memoria y no existe
limite de longitud.
Para evitar los dos casos anteriores, el programador deberia estar
seguro de que n es mayor o igual a wcstombs(NULL,src,0)+1.
VALOR DEVUELTO
la funcion wcstombs devuelve el numero de bytes que conforman la parte
de la secuencia multibyte convertida, sin incluir el byte nulo
terminador. Si encontro un caracter ancho que no pudo convertir,
devuelve (size_t)(-1).
CONFORME A
ISO/ANSI C, UNIX98
V'EASE TAMBI'EN
wcsrtombs(3)
OBSERVACIONES
El comportamiento de wcstombs depende de la categoria LC_CTYPE de la
localizacion actual.
La funcion wcsrtombs proporciona un interfaz seguro para hilos con la
misma funcionalidad.