draft/man3/getwchar.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   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.
   7 .\"
   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
  12 .\"      http://www.UNIX-systems.org/online.html
  13 .\"   ISO/IEC 9899:1999
  14 .\"
  15 .\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
  16 .\"         all rights reserved.
  17 .\" Translated Tue Jan 11 00:56:29 JST 2000
  18 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  19 .\" Updated Sat Nov  3 JST 2001 by Kentaro Shirakata <argrath@ub32.org>
  20 .\"
  21 .TH GETWCHAR 3  1999-07-25 "GNU" "Linux Programmer's Manual"
  22 .\"O .SH NAME
  23 .SH Ì¾Á°
  24 .\"O getwchar \- read a wide character from standard input
  25 getwchar \- É¸½àÆþÎÏ¤è¤ê¥ï¥¤¥ÉÊ¸»ú¤òÆÉ¤ß¹þ¤à
  26 .\"O .SH SYNOPSIS
  27 .SH ½ñ¼°
  28 .nf
  29 .B #include <wchar.h>
  30 .sp
  31 .B "wint_t getwchar(void);"
  32 .fi
  33 .\"O .SH DESCRIPTION
  34 .SH ÀâÌÀ
  35 .\"O The
  36 .\"O .BR getwchar ()
  37 .\"O function is the wide-character equivalent of the
  38 .\"O .BR getchar (3)
  39 .\"O function.
  40 .\"O It reads a wide character from \fIstdin\fP and returns
  41 .\"O it.
  42 .\"O If the end of stream is reached, or if \fIferror(stdin)\fP becomes
  43 .\"O true, it returns
  44 .\"O .BR WEOF .
  45 .\"O If a wide character conversion error occurs, it sets
  46 .\"O \fIerrno\fP to \fBEILSEQ\fP and returns
  47 .\"O .BR WEOF .
  48 .BR getwchar ()
  49 ´Ø¿ô¤Ï
  50 .BR getchar (3)
  51 ´Ø¿ô¤Î¥ï¥¤¥ÉÊ¸»úÈÇ¤Ç¤¢¤ë¡£
  52 \fBstdin\fP ¤«¤é¥ï¥¤¥ÉÊ¸»ú¤òÆÉ¤ß¹þ¤ó¤Ç¤½¤ì¤òÊÖ¤¹¡£
  53 ¥¹¥È¥ê¡¼¥à¤ÎºÇ¸å¤ËÃ£¤·¤Æ¤¤¤ë¾ì¹ç¤ä \fIferror(stdin)\fP ¤¬¿¿¤Î¾ì¹ç¤Ë¤Ï
  54 .B WEOF
  55 ¤òÊÖ¤¹¡£¥ï¥¤¥ÉÊ¸»úÊÑ´¹¤Ç¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç¤Ë¤Ï \fIerrno\fP ¤Ë
  56 \fBEILSEQ\fP ¤òÀßÄê¤·¤Æ
  57 .B WEOF
  58 ¤òÊÖ¤¹¡£
  59 .PP
  60 .\"O For nonlocking counterparts, see
  61 .\"O .BR unlocked_stdio (3).
  62 ¤³¤ì¤é¤Î½èÍý¤ò¥í¥Ã¥¯¤»¤º¤Ë¹Ô¤¤¤¿¤¤¤È¤¤Ï¡¢
  63 .BR unlocked_stdio (3)
  64 ¤ò»²¾È¤Î¤³¤È¡£
  65 .\"O .SH "RETURN VALUE"
  66 .SH ÊÖ¤êÃÍ
  67 .\"O The
  68 .\"O .BR getwchar ()
  69 .\"O function returns the next wide-character from
  70 .\"O standard input, or
  71 .\"O .BR WEOF .
  72 .BR getwchar ()
  73 ´Ø¿ô¤ÏÉ¸½àÆþÎÏ¤Î¼¡¤Î¥ï¥¤¥ÉÊ¸»ú¤òÊÖ¤¹¤«¡¢
  74 .B WEOF
  75 ¤òÊÖ¤¹¡£
  76 .\"O .SH "CONFORMING TO"
  77 .SH ½àµò
  78 C99.
  79 .\"O .SH NOTES
  80 .SH Ãí°Õ
  81 .\"O The behavior of
  82 .\"O .BR getwchar ()
  83 .\"O depends on the
  84 .\"O .B LC_CTYPE
  85 .\"O category of the
  86 .\"O current locale.
  87 .BR getwchar ()
  88 ¤ÎÆ°ºî¤Ï¸½ºß¤Î¥í¥±¡¼¥ë¤Î
  89 .B LC_CTYPE
  90 ¥«¥Æ¥´¥ê¤Ë°ÍÂ¸¤·¤Æ¤¤¤ë¡£
  91 .PP
  92 .\"O It is reasonable to expect that
  93 .\"O .BR getwchar ()
  94 .\"O will actually read a multibyte
  95 .\"O sequence from standard input and then convert it to a wide character.
  96 .BR getwchar ()
  97 ¤¬¼ÂºÝ¤Ë¤ÏÉ¸½àÆþÎÏ¤«¤é¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤òÆÉ¤ß¹þ¤ó¤Ç
  98 ¥ï¥¤¥ÉÊ¸»ú¤ËÊÑ´¹¤¹¤ë¤³¤È¤ò´üÂÔ¤·¤Æ¤âÎÉ¤¤¡£
  99 .\"O .SH "SEE ALSO"
 100 .SH ´ØÏ¢¹àÌÜ
 101 .BR fgetwc (3),
 102 .BR unlocked_stdio (3)