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

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.