|| FreeBSD Library Functions Manual
convert a wide-character string to a character string
Standard C Library (libc, -lc)
#include < stdlib.h>
wcstombs( char * restrict mbstring, const wchar_t * restrict wcstring, size_t nbytes);
wcstombs() 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 character string is null terminated if there is room.
RETURN VALUES The
wcstombs() function returns the number of bytes converted (not including any terminating null), if successful, otherwise it returns (
() function will fail if:
An invalid wide character was encountered.
The conversion state is invalid.
wcstombs() function conforms to ISO/IEC 9899:1999 (“ISO C99”).