man.bsd.lv manual page server

Manual Page Search Parameters
WCSTOMBS(3) Library Functions Manual WCSTOMBS(3)

wcstombs, wcstombs_lconvert a wide-character string to a character string

library “libc”

#include <stdlib.h>

size_t
wcstombs(char * restrict mbstring, const wchar_t * restrict wcstring, size_t nbytes);

#include <xlocale.h>

size_t
wcstombs_l(char * restrict mbstring, const wchar_t * restrict wcstring, size_t nbytes, locale_t locale);

The () and wcstombs_l() functions convert 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 character string is null terminated if there is room.

The () function takes an explicit locale argument, whereas the wcstombs() function uses the current global or per-thread locale.

The wcstombs() and wcstombs_l() functions return the number of bytes converted (not including any terminating null), if successful, otherwise they return (size_t)-1.

The wcstombs() and wcstombs_l() functions will fail if:

[]
An invalid wide character was encountered.
[]
The conversion state is invalid.

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

The wcstombs() function conforms to ISO/IEC 9899:1999 (“ISO C99”).

December 27, 2013 DragonFly-5.6.1