wcstombs(3) [osx man page]
WCSTOMBS(3) BSD Library Functions Manual WCSTOMBS(3) NAME
wcstombs, wcstombs_l -- convert a wide-character string to a character string LIBRARY
Standard C Library (libc, -lc) SYNOPSIS
#include <stdlib.h> size_t wcstombs(char *restrict s, const wchar_t *restrict pwcs, size_t n); #include <stdlib.h> #include <xlocale.h> size_t wcstombs_l(char *restrict s, const wchar_t *restrict pwcs, size_t n, locale_t loc); DESCRIPTION
The wcstombs() function converts a wide character string pwcs into a multibyte character string, s, beginning in the initial conversion state. Up to n bytes are stored in s. Partial multibyte characters at the end of the string are not stored. The multibyte character string is null terminated, if there is room. Although the wcstombs() function uses the current locale, the wcstombs_l() function may be passed a locale directly. See xlocale(3) for more information. RETURN VALUES
The wcstombs() function returns the number of bytes converted (not including any terminating null), if successful; otherwise, it returns (size_t)-1. ERRORS
The wcstombs() 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 wcstombs() function conforms to ISO/IEC 9899:1999 (``ISO C99''). BSD
April 8, 2004 BSD
Check Out this Related Man Page
MBSTOWCS(3) BSD Library Functions Manual MBSTOWCS(3) NAME
mbstowcs, mbstowcs_l -- convert a character string to a wide-character string LIBRARY
Standard C Library (libc, -lc) SYNOPSIS
#include <stdlib.h> size_t mbstowcs(wchar_t *restrict pwcs, const char *restrict s, size_t n); #include <stdlib.h> #include <xlocale.h> size_t mbstowcs_l(wchar_t *restrict pwcs, const char *restrict s, size_t n, locale_t loc); DESCRIPTION
The mbstowcs() function converts a multibyte character string s, beginning in the initial conversion state, into a wide character string pwcs. No more than n wide characters are stored. A terminating null wide character is appended, if there is room. Although the mbstowcs() function uses the current locale, the mbstowcs_l() function may be passed a locale directly. See xlocale(3) for more information. RETURN VALUES
The mbstowcs() function returns the number of wide characters converted, not counting any terminating null wide character, or -1 if an invalid multibyte character was encountered. ERRORS
The mbstowcs() function will fail if: [EILSEQ] An invalid multibyte sequence was detected. [EINVAL] The conversion state is invalid. SEE ALSO
mbsrtowcs(3), mbtowc(3), multibyte(3), xlocale(3) STANDARDS
The mbstowcs() function conforms to ISO/IEC 9899:1999 (``ISO C99''). BSD
April 8, 2004 BSD