.\" Dinkumware C library reference http://www.dinkumware.com/
.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"
-.TH WCSNRTOMBS 3 2011-10-16 "GNU" "Linux Programmer's Manual"
+.TH WCSNRTOMBS 3 2014-03-18 "GNU" "Linux Programmer's Manual"
.SH NAME
wcsnrtombs \- convert a wide-character string to a multibyte string
.SH SYNOPSIS
.PP
If
.I dest
-is not a NULL pointer,
+is not NULL,
the
.BR wcsnrtombs ()
function converts
.IP 1. 3
A wide character has been encountered that can not be represented as a
multibyte sequence (according to the current locale).
-In this case
+In this case,
.I *src
is left pointing to the invalid wide character,
.I (size_t)\ \-1
wide characters have been
converted without encountering a null wide character (L\(aq\\0\(aq),
or the length limit forces a stop.
-In this case
+In this case,
.I *src
is left pointing
to the next wide character to be converted, and the number of bytes written
terminating null wide character (which has the side effect of bringing back
.I *ps
to the initial state).
-In this case
+In this case,
.I *src
is set to NULL, and the number
of bytes written to
In both of the above cases,
if
.I ps
-is a NULL pointer, a static anonymous
+is NULL, a static anonymous
state known only to the
.BR wcsnrtombs ()
function is used instead.
is not multithread safe.
.SH SEE ALSO
.BR iconv (3),
+.BR mbsinit (3),
.BR wcsrtombs (3)
+.SH COLOPHON
+This page is part of release 3.65 of the Linux
+.I man-pages
+project.
+A description of the project,
+and information about reporting bugs,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.