diff options
Diffstat (limited to 'man3/wcstombs.3')
| -rw-r--r-- | man3/wcstombs.3 | 16 |
1 files changed, 12 insertions, 4 deletions
diff --git a/man3/wcstombs.3 b/man3/wcstombs.3 index 2e2e286a3d..c4ab6d215b 100644 --- a/man3/wcstombs.3 +++ b/man3/wcstombs.3 @@ -21,7 +21,9 @@ wcstombs \- convert a wide-character string to a multibyte string .BI "size_t wcstombs(char *" dest ", const wchar_t *" src ", size_t " n ); .fi .SH DESCRIPTION -If \fIdest\fP is not a NULL pointer, the \fBwcstombs\fP() function converts +If \fIdest\fP is not a NULL pointer, the +.BR wcstombs () +function converts the wide-character string \fIsrc\fP to a multibyte string starting at \fIdest\fP. At most \fIn\fP bytes are written to \fIdest\fP. @@ -54,7 +56,9 @@ and that no length limit exists. In order to avoid the case 2 above, the programmer should make sure \fIn\fP is greater or equal to \fIwcstombs(NULL,src,0)+1\fP. .SH "RETURN VALUE" -The \fBwcstombs\fP() function returns the number of bytes that make up the +The +.BR wcstombs () +function returns the number of bytes that make up the converted part of multibyte sequence, not including the terminating null byte. If a wide character was encountered which could not be converted, (size_t)(\-1) is returned. @@ -63,8 +67,12 @@ C99. .SH "SEE ALSO" .BR wcsrtombs (3) .SH NOTES -The behaviour of \fBwcstombs\fP() depends on the LC_CTYPE category of the +The behaviour of +.BR wcstombs () +depends on the LC_CTYPE category of the current locale. .PP -The function \fBwcsrtombs\fP(3) provides a thread safe interface to +The function +.BR wcsrtombs (3) +provides a thread safe interface to the same functionality. |