.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\" ISO/IEC 9899:1999
.\"
-.TH WCSTOMBS 3 1999-07-25 "GNU" "Linux Programmer's Manual"
+.TH WCSTOMBS 3 2011-10-16 "GNU" "Linux Programmer's Manual"
.SH NAME
wcstombs \- convert a wide-character string to a multibyte string
.SH SYNOPSIS
\fIdest\fP is returned, but the shift state at this point is lost.
.PP
3. The wide-character string has been completely converted, including the
-terminating L\(aq\\0\(aq.
+terminating null wide character (L\(aq\\0\(aq).
In this case the conversion ends in the initial state.
The number of bytes written to \fIdest\fP,
-excluding the terminating \(aq\\0\(aq byte, is returned.
+excluding the terminating null byte (\(aq\\0\(aq), is returned.
.PP
The programmer must ensure that there is room for at least \fIn\fP bytes
at \fIdest\fP.
provides a thread safe interface to
the same functionality.
.SH "SEE ALSO"
+.BR mbstowcs (3),
.BR wcsrtombs (3)