NOMBRE

       wcstombs - convierte una cadena de caracteres anchos a una cadena mulibyte

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

SINOPSIS

       #include <stdlib.h>

       size_t wcstombs(char dest[restrict .n], const wchar_t *restrict src,
                       size_t n);

DESCRIPCIÓN

       Si  dest  no  es  un puntero NULL, la función wcstombs() convierte la cadena de caracteres
       anchos src en una cadena multibyte comenzando en dest. En dest se escriben, como mucho,  n
       bytes.   La  secuencia de caracteres en  dest comienza en el estado inicial. La conversión
       puede pararse por tres razones:

       •  Se ha encontrado un carácter ancho que no  se  puede  representar  como  una  secuencia
          multibyte   (de  acuerdo  con  la  localización  actual).  En  este  caso  se  devuelve
          (size_t) -1.

       •  El límite de longitud fuerza la parada. En este  caso,  devuelve  el  número  de  bytes
          escritos en dest pero el estado de cambios en este punto se pierde.

       •  The wide-character string has been completely converted, including the terminating null
          wide character (L'\0').  In this case, the conversion ends in the initial shift  state.
          The  number  of  bytes  written to dest, excluding the terminating null byte ('\0'), is
          returned.

       El programador tiene que asegurarse de que hay espacio para al menos n bytes en dest.

       Si dest es NULL, n se ignora, y la conversión procede como arriba,  salvo  que  los  bytes
       convertidos no se escriben en memoria, y no existe límite de longitud.

       Para  evitar  los  dos  casos  anteriores, el programador debería estar seguro de que n es
       mayor o igual a wcstombs(NULL,src,0)+1.

VALOR DEVUELTO

       La función wcstombs() devuelve el número de bytes que conforman la parte de  la  secuencia
       multibyte  convertida,  sin incluir el byte nulo terminador. Si encontró un carácter ancho
       que no pudo convertir, devuelve (size_t) -1.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

       ┌────────────────────────────────────────────────┬────────────────────┬───────────────────┐
       │Interfaz                                        │ Atributo           │ Valor             │
       ├────────────────────────────────────────────────┼────────────────────┼───────────────────┤
       │wcstombs()                                      │ Seguridad del hilo │ Multi-hilo seguro │
       └────────────────────────────────────────────────┴────────────────────┴───────────────────┘

ESTÁNDARES

       POSIX.1-2001, POSIX.1-2008, C99.

NOTAS

       El comportamiento de wcstombs() depende  de  la  categoría  LC_CTYPE  de  la  localización
       actual.

       La   función  wcsrtombs(3)  proporciona  un  interfaz  seguro  para  hilos  con  la  misma
       funcionalidad.

VÉASE TAMBIÉN

       mblen(3), mbstowcs(3), mbtowc(3), wcsrtombs(3), wctomb(3)

TRADUCCIÓN

       La traducción al español de esta página del manual fue  creada  por  Pedro  Pablo  Fábrega
       <pfabrega@arrakis.es> y Juan Piernas <piernas@ditec.um.es>

       Esta  traducción  es  documentación  libre;  lea  la  GNU General Public License Version 3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ o posterior con respecto a las condiciones  de
       copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si  encuentra  algún  error  en  la  traducción de esta página del manual, envíe un correo
       electrónico a ⟨debian-l10n-spanish@lists.debian.org⟩.