mbstowcs(3) [freebsd man page]

MBSTOWCS(3)						   BSD Library Functions Manual 					       MBSTOWCS(3)

NAME

     mbstowcs -- 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 wcstring, const char * restrict mbstring, size_t nwchars);

DESCRIPTION

     The mbstowcs() function converts a multibyte character string mbstring beginning in the initial conversion state into a wide character string
     wcstring.	No more than nwchars wide characters are stored.  A terminating null wide character is appended if there is room.

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)

STANDARDS

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

BSD
								   April 8, 2004							       BSD

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

NAME

     wcstombs -- convert a wide-character string to a character string

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <stdlib.h>

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

DESCRIPTION

     The wcstombs() function converts a wide character string wcstring into a multibyte character string, mbstring, beginning in the initial con-
     version state.  Up to nbytes bytes are stored in mbstring.  Partial multibyte characters at the end of the string are not stored.	The multi-
     byte 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
     (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)

STANDARDS

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

BSD
								   April 8, 2004							       BSD