1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" This is free documentation; you can redistribute it and/or
4 .\" modify it under the terms of the GNU General Public License as
5 .\" published by the Free Software Foundation; either version 2 of
6 .\" the License, or (at your option) any later version.
8 .\" References consulted:
9 .\" GNU glibc-2 source code and manual
10 .\" Dinkumware C library reference http://www.dinkumware.com/
11 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
14 .TH BTOWC 3 2009-02-04 "GNU" "Linux Programmer's Manual"
16 btowc \- convert single byte to wide character
21 .BI "wint_t btowc(int " c );
26 function converts \fIc\fP,
27 interpreted as a multibyte sequence
28 of length 1, starting in the initial shift state, to a wide character and
32 or not a valid multibyte sequence of length 1,
40 function returns the wide character
41 converted from the single byte \fIc\fP.
44 or not a valid multibyte sequence of length 1,
57 This function should never be used.
58 It does not work for encodings which have
59 state, and unnecessarily treats single bytes differently from multibyte