diff options
author | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-04-12 22:42:49 +0000 |
---|---|---|
committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-04-12 22:42:49 +0000 |
commit | c13182efa3b3d77f2563034c8212c0ca798243ca (patch) | |
tree | e7652b26018b7c22cd6a4e4b41404dfaab911303 /man3/btowc.3 | |
parent | 4174ff5658082832c2ed511720f18881b3a80a34 (diff) |
Wrapped long lines, wrapped at sentence boundaries; stripped trailing
white space.
Diffstat (limited to 'man3/btowc.3')
-rw-r--r-- | man3/btowc.3 | 17 |
1 files changed, 11 insertions, 6 deletions
diff --git a/man3/btowc.3 b/man3/btowc.3 index 0922815f..c25caa89 100644 --- a/man3/btowc.3 +++ b/man3/btowc.3 @@ -21,13 +21,16 @@ btowc \- convert single byte to wide character .BI "wint_t btowc(int " c ); .fi .SH DESCRIPTION -The \fBbtowc\fP() function converts \fIc\fP, interpreted as a multibyte sequence +The \fBbtowc\fP() function converts \fIc\fP, +interpreted as a multibyte sequence of length 1, starting in the initial shift state, to a wide character and -returns it. If \fIc\fP is EOF or not a valid multibyte sequence of length 1, +returns it. +If \fIc\fP is EOF or not a valid multibyte sequence of length 1, the \fBbtowc\fP() function returns WEOF. .SH "RETURN VALUE" -The \fBbtowc\fP() function returns the wide character converted from the single -byte \fIc\fP. If \fIc\fP is EOF or not a valid multibyte sequence of length 1, +The \fBbtowc\fP() function returns the wide character +converted from the single byte \fIc\fP. +If \fIc\fP is EOF or not a valid multibyte sequence of length 1, it returns WEOF. .SH "CONFORMING TO" C99, POSIX.1-2001. @@ -37,6 +40,8 @@ C99, POSIX.1-2001. The behaviour of \fBbtowc\fP() depends on the LC_CTYPE category of the current locale. .PP -This function should never be used. It does not work for encodings which have +This function should never be used. +It does not work for encodings which have state, and unnecessarily treats single bytes differently from multibyte -sequences. Use the function \fBmbtowc\fP() instead. +sequences. +Use the function \fBmbtowc\fP() instead. |