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 .\" Japanese Version Copyright (c) 1999 HAYAKAWA Hitoshi
15 .\" all rights reserved.
16 .\" Translated Sep 11 1999, HAYAKAWA Hitoshi <cz8cb01@linux.or.jp>
18 .\"WORD: locale ¥í¥±¡¼¥ë
19 .\"WORD: convert ¥³¥ó¥Ð¡¼¥È
20 .\"WORD: single byte ¥·¥ó¥°¥ë¥Ð¥¤¥È
21 .\"WORD: wide character ¥ï¥¤¥É¥¥ã¥é¥¯¥¿¡¼
24 .TH BTOWC 3 2009-02-04 "GNU" "Linux Programmer's Manual"
26 .\"O btowc \- convert single byte to wide character
28 btowc \- ¥·¥ó¥°¥ë¥Ð¥¤¥È¤ò¥ï¥¤¥Éʸ»ú¤Ë¥³¥ó¥Ð¡¼¥È¤¹¤ë
34 .BI "wint_t btowc(int " c );
40 .\"O function converts \fIc\fP, interpreted as a multibyte sequence
41 .\"O of length 1, starting in the initial shift state, to a wide character and
45 .\"O or not a valid multibyte sequence of length 1,
51 ´Ø¿ô¤Ï½é´ü¥·¥Õ¥È¾õÂÖ¤«¤é»Ï¤Þ¤ëŤµ 1 ¤Î¥Þ¥ë¥Á¥Ð¥¤¥È¤Î¥·¡¼¥±¥ó¥¹¤È¤·¤Æ
52 ²ò¼á¤µ¤ì¡¢\fIc\fP ¤ò¥ï¥¤¥Éʸ»ú¤Ë¥³¥ó¥Ð¡¼¥È¤·¤ÆÊÖ¤¹¡£
55 ¤â¤·¤¯¤ÏŤµ 1 ¤Î̵¸ú¤Ê¥Þ¥ë¥Á¥Ð¥¤¥È¥·¡¼¥±¥ó¥¹¤Î¾ì¹ç¡¢
60 .\"O .SH "RETURN VALUE"
64 .\"O function returns the wide character
65 .\"O converted from the single byte \fIc\fP.
68 .\"O or not a valid multibyte sequence of length 1,
72 ´Ø¿ô¤Ï¥·¥ó¥°¥ë¥Ð¥¤¥È \fIc\fP ¤«¤é¥³¥ó¥Ð¡¼¥È¤µ¤ì¤¿¥ï¥¤¥Éʸ»ú¤òÊÖ¤¹¡£
75 ¤â¤·¤¯¤ÏŤµ 1 ¤Î̵¸ú¤Ê¥Þ¥ë¥Á¥Ð¥¤¥È¥·¡¼¥±¥ó¥¹¤Î¾ì¹ç¡¢
80 .\"O .SH "CONFORMING TO"
91 .\"O This function should never be used.
92 .\"O It does not work for encodings which have
93 .\"O state, and unnecessarily treats single bytes differently from multibyte
100 ¤Î¿¶¤ëÉñ¤¤¤Ï¡¢¸½ºß¤Î¥í¥±¡¼¥ë¤Î
102 ¥«¥Æ¥´¥ê¡¼¤Ë°Í¸¤¹¤ë¡£
104 ¤³¤Î´Ø¿ô¤Ï»ÈÍѤµ¤ì¤ë¤Ù¤¤Ç¤Ï¤Ê¤¤¡£¾õÂÖ(state)¤ò»ý¤Ã¤¿¥¨¥ó¥³¡¼¥É¤Ë¤Ï»È¤¨¤º¡¢
105 ¥Þ¥ë¥Á¥Ð¥¤¥È¥·¡¼¥±¥ó¥¹¤È¤Ï°ã¤¤¡¢É¬¤º¤·¤â¥·¥ó¥°¥ë¥Ð¥¤¥È
106 ¤ò¼è¤ê°·¤¨¤ë¤È¤Ï¸Â¤é¤Ê¤¤¡£
108 ¤òÂå¤ï¤ê¤È¤·¤Æ»ÈÍѤ·¤Ê¤µ¤¤¡£