| WCSTOMBS(3) | Library Functions Manual | WCSTOMBS(3) | 
wcstombs —
#include <stdlib.h>
size_t
  
  wcstombs(char
    * restrict s, const
    wchar_t * restrict pwcs,
    size_t n);
wcstombs() converts the nul-terminated wide-character
  string pointed to by pwcs to the corresponding multibyte
  character string, and stores it in the array pointed to by
  s. This function may modify the first at most
  n bytes of the array pointed to by
  s. Each character will be converted as if
  wctomb(3) is continuously
  called, except the internal state of
  wctomb(3) will not be affected.
For state-dependent encoding, the
    wcstombs() implies the result multibyte character
    string pointed to by s always to begin with an initial
    state.
The behaviour of wcstombs() is affected by
    the LC_CTYPE category of the current locale.
These are the special cases:
wcstombs() returns the number of bytes to
      store the whole multibyte character string corresponding to the
      wide-character string pointed to by pwcs. In this
      case, n is ignored.wcstombs() returns:
wcstombs() also sets
      errno to indicate the error.wcstombs() may cause an error in the following case:
EILSEQ]wcstombs() function conforms to
  ANSI X3.159-1989 (“ANSI C89”).
  The restrict qualifier is added at ISO/IEC 9899:1999
  (“ISO C99”).
| March 16, 2011 | NetBSD 9.3 |