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)