WCSTOMBS(3) BSD Library Functions Manual WCSTOMBS(3)

NAME
     wwccssttoommbbss, wwccssttoommbbssll - convert a wide-character string to a character
     string

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     sizet
     wwccssttoommbbss(char * restrict mbstring, const wchart * restrict wcstring,
         sizet nbytes);

     ##iinncclluuddee <>

     sizet
     wwccssttoommbbssll(char * restrict mbstring, const wchart * restrict wcstring,
         sizet nbytes, localet loc);

DESCRIPTION
     The wwccssttoommbbss() function converts a wide character string wcstring into a
     multibyte character string, mbstring, beginning in the initial conversion
     state.  Up to nbytes bytes are stored in mbstring.  Partial multibyte
     characters at the end of the string are not stored.  The multibyte char-
     acter string is null terminated if there is room.

     While the wwccssttoommbbss() function uses the current locale, the wwccssttoommbbssll()
     function may be passed a locale directly. See xlocale(3) for more infor-
     mation.

RETURN VALUES
     The wwccssttoommbbss() function returns the number of bytes converted (not
     including any terminating null), if successful, otherwise it returns
     (sizet)-1.

EERRRROORRSS
     The wwccssttoommbbss() function will fail if:

     [EILSEQ]           An invalid wide character was encountered.

     [EINVAL]           The conversion state is invalid.

SEE ALSO
     mbstowcs(3), multibyte(3), wcsrtombs(3), wctomb(3), xlocale(3)

STANDARDS     The wwccssttoommbbss() function conforms to ISO/IEC 9899:1999 (``ISO C99'').

BSD                              April 8, 2004                             BSD