draft/man3/wctob.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 http://www.UNIX-systems.org/online.html
  12 .\"   ISO/IEC 9899:1999
  13 .\"
  14 .\" About this Japanese page, please contact to JM Project <JM@linux.or.jp>
  15 .\" Translated Sat Oct 23 19:35:47 JST 1999
  16 .\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
  17 .\"
  18 .TH WCTOB 3 2011-09-22 "GNU" "Linux Programmer's Manual"
  19 .\"O .SH NAME
  20 .SH Ì¾Á°
  21 .\"O wctob \- try to represent a wide character as a single byte
  22 wctob \- ¥ï¥¤¥ÉÊ¸»ú¤Î¥·¥ó¥°¥ë¥Ð¥¤¥ÈÉ½¸½¤ò»î¤ß¤ë
  23 .\"O .SH SYNOPSIS
  24 .SH ½ñ¼°
  25 .nf
  26 .B #include <wchar.h>
  27 .sp
  28 .BI "int wctob(wint_t " c );
  29 .fi
  30 .\"O .SH DESCRIPTION
  31 .SH ÀâÌÀ
  32 .\"O The
  33 .\"O .BR wctob ()
  34 .\"O function tests whether
  35 .\"O the multibyte representation of the
  36 .\"O wide character \fIc\fP, starting in the initial state, consists of a single
  37 .\"O byte.
  38 .\"O If so, it is returned as an
  39 .\"O .IR "unsigned char" .
  40 .BR wctob ()
  41 ´Ø¿ô¤Ï¡¢¥ï¥¤¥ÉÊ¸»ú \fIc\fP ¤Î¥Þ¥ë¥Á¥Ð¥¤¥ÈÉ½¸½(½é´ü¾õÂÖ¤Ç³«
  42 »Ï)¤¬¥·¥ó¥°¥ë¥Ð¥¤¥ÈÊ¸»ú¤À¤±¤Ç¤Ç¤¤Æ¤¤¤ë¤«¤É¤¦¤«¤òÄ´¤Ù¤ë¡£¤â¤·¤½¤¦¤Ç¤¢
  43 ¤ì¤Ð¡¢¤³¤ì¤ò
  44 .I "unsigned char"
  45 ·¿¤È¤·¤ÆÊÖ¤¹¡£
  46 .PP
  47 .\"O Never use this function.
  48 .\"O It cannot help you in writing internationalized
  49 .\"O programs.
  50 .\"O Internationalized programs must never distinguish single-byte and
  51 .\"O multibyte characters.
  52 ¤³¤Î´Ø¿ô¤Ï·è¤·¤Æ»È¤ï¤Ê¤¤¤³¤È¡£¤³¤Î´Ø¿ô¤Ï¹ñºÝ²½¥×¥í¥°¥é¥à¤ò½ñ¤¯¾å¤Ç¤ÏÌò
  53 ¤ËÎ©¤¿¤Ê¤¤¡£¹ñºÝ²½¤µ¤ì¤¿¥×¥í¥°¥é¥à¤Ç¤Ï¡¢¥·¥ó¥°¥ë¥Ð¥¤¥ÈÊ¸»ú¤È¥Þ¥ë¥Á¥Ð¥¤¥È
  54 Ê¸»ú¤ò¶èÊÌ¤·¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£
  55 .\"O .SH "RETURN VALUE"
  56 .SH ÊÖ¤êÃÍ
  57 .\"O The
  58 .\"O .BR wctob ()
  59 .\"O function returns the single-byte representation of \fIc\fP,
  60 .\"O if it exists, of \fBEOF\fP otherwise.
  61 .BR wctob ()
  62 ´Ø¿ô¤Ï \fIc\fP ¤Î¥·¥ó¥°¥ë¥Ð¥¤¥ÈÉ½¸½¤¬Â¸ºß¤¹¤ì¤Ð¡¢¤½¤ÎÉ½¸½
  63 ¤òÊÖ¤¹¡£Â¸ºß¤·¤Ê¤±¤ì¤Ð \fBEOF\fP ¤òÊÖ¤¹¡£
  64 .\"O .SH "CONFORMING TO"
  65 .SH ½àµò
  66 C99.
  67 .\"O .SH NOTES
  68 .SH Ãí°Õ
  69 .\"O The behavior of
  70 .\"O .BR wctob ()
  71 .\"O depends on the
  72 .\"O .B LC_CTYPE
  73 .\"O category of the
  74 .\"O current locale.
  75 .BR wctob ()
  76 ¤ÎÆ°ºî¤Ï¡¢¸½ºß¤Î¥í¥±¡¼¥ë¤Î
  77 .B LC_CTYPE
  78 ¥«¥Æ¥´¥ê¤Ë°ÍÂ¸¤¹¤ë¡£
  79 .PP
  80 .\"O This function should never be used.
  81 .\"O Internationalized programs must never
  82 .\"O distinguish single-byte and multibyte characters.
  83 .\"O- Use the function
  84 .\"O+ Use either
  85 .\"O .BR wctomb (3)
  86 .\"O+ or the thread-safe
  87 .\"O+ .BR wcrtomb (3)
  88 .\"O instead.
  89 ¤³¤Î´Ø¿ô¤Ï·è¤·¤Æ»È¤¦¤Ù¤¤Ç¤Ï¤Ê¤¤¡£¹ñºÝ²½¥×¥í¥°¥é¥à¤Ç¤Ï¡¢¥·¥ó¥°¥ë¥Ð¥¤¥È
  90 Ê¸»ú¤È¥Þ¥ë¥Á¥Ð¥¤¥ÈÊ¸»ú¤ò¶èÊÌ¤·¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£Âå¤ï¤ê¤Ë¡¢
  91 .BR wctomb (3)
  92 ¤«¡¢¥¹¥ì¥Ã¥É¥»¡¼¥Õ¤Ê
  93 .BR wcrtomb (3)
  94 ¤ò»È¤¦¤³¤È¡£
  95 .\"O .SH "SEE ALSO"
  96 .SH ´ØÏ¢¹àÌÜ
  97 .BR btowc (3),
  98 .BR wcrtomb (3),
  99 .BR wctomb (3)