NAME wcstombs - convert a wide-character string to a character string CONTENTS Library Synopsis Description Return Values Errors See Also Standards LIBRARY .Lb libc SYNOPSIS .In stdlib.h size_t .Fo wcstombs "char * restrict mbstring" "const wchar_t * restrict wcstring" "size_t nbytes" .Fc DESCRIPTION The 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 (Vt size_t-1). ERRORS The wcstombs function will fail if: