1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
10 .\" References consulted:
11 .\" GNU glibc-2 source code and manual
12 .\" Dinkumware C library reference http://www.dinkumware.com/
13 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
16 .TH BTOWC 3 2011-09-22 "GNU" "Linux Programmer's Manual"
18 btowc \- convert single byte to wide character
23 .BI "wint_t btowc(int " c );
28 function converts \fIc\fP,
29 interpreted as a multibyte sequence
30 of length 1, starting in the initial shift state, to a wide character and
34 or not a valid multibyte sequence of length 1,
42 function returns the wide character
43 converted from the single byte \fIc\fP.
46 or not a valid multibyte sequence of length 1,
59 This function should never be used.
60 It does not work for encodings which have
61 state, and unnecessarily treats single bytes differently from multibyte
73 This page is part of release 3.67 of the Linux
76 A description of the project,
77 information about reporting bugs,
78 and the latest version of this page,
80 \%http://www.kernel.org/doc/man\-pages/.