draft/man3/mbsinit.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
   4 .\" This is free documentation; you can redistribute it and/or
   5 .\" modify it under the terms of the GNU General Public License as
   6 .\" published by the Free Software Foundation; either version 2 of
   7 .\" the License, or (at your option) any later version.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\" References consulted:
  11 .\"   GNU glibc-2 source code and manual
  12 .\"   Dinkumware C library reference http://www.dinkumware.com/
  13 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  14 .\"   ISO/IEC 9899:1999
  15 .\"
  16 .\"*******************************************************************
  17 .\"
  18 .\" This file was generated with po4a. Translate the source file.
  19 .\"
  20 .\"*******************************************************************
  21 .\"
  22 .\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
  23 .\"         all rights reserved.
  24 .\" Translated Tue Jan 11 00:56:13 JST 2000
  25 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  26 .\"
  27 .TH MBSINIT 3 2014\-03\-18 GNU "Linux Programmer's Manual"
  28 .SH 名前
  29 mbsinit \- 初期シフト状態かどうかを検査する
  30 .SH 書式
  31 .nf
  32 \fB#include <wchar.h>\fP
  33 .sp
  34 \fBint mbsinit(const mbstate_t *\fP\fIps\fP\fB);\fP
  35 .fi
  36 .SH 説明
  37 文字をマルチバイト表現とワイド文字表現の間で変換する場合には \fImbstate_t\fP 型の変換状態を使用する。文字列の変換は有限状態マシン
  38 を使用する。いくらかの文字の変換を完了した後に、残りの文字を処理する ために状態を保存しておく必要があるかもしれない。このような変換状態は
  39 ISO\-2022 や UTF\-7 のような符号を扱うのに必要とされる。
  40 .PP
  41 初期状態とは文字列の変換を開始する時の状態である。状態には二種類が 存在し、一つは \fBmbsrtowcs\fP(3)  のようなマルチバイトをワイド文字に
  42 変換する関数で使用される。もう一つは \fBwcsrtombs\fP(3)  のような ワイド文字をマルチバイトに変換する関数で使用される。しかし両方とも
  43 \fImbstate_t\fP に格納され、初期状態として同じ表現を持つ。
  44 .PP
  45 8ビット符号においては全ての状態は初期状態と等価である。 UTF\-8, EUC\-*, BIG5, SJIS のような多バイト符号においてワイド文字から
  46 多バイト文字への変換関数は非初期状態にはならない。 しかし \fBmbrtowc\fP(3)  のような多バイト文字からワイド文字への変換関数では
  47 文字の解釈の途中で非初期状態となる場合がある。
  48 .PP
  49 初期状態の \fImbstate_t\fP を作成する方法の一つは、それをゼロに設定することである:
  50 .nf
  51
  52     mbstate_t state;
  53     memset(&state,0,sizeof(mbstate_t));
  54 .fi
  55 .PP
  56 Linux においては以下の方法でも同様であるが、コンパイラーの警告が 生成されるかもしれない。
  57 .nf
  58
  59     mbstate_t state = { 0 };
  60 .fi
  61 .PP
  62 \fBmbsinit\fP()  は \fI*ps\fP が初期状態に一致するかどうかを検査する。
  63 .SH 返り値
  64 \fBmbsinit\fP()  は \fI*ps\fP が初期状態の場合や NULL の場合には ゼロ以外を返す。それ以外の場合にはゼロを返す。
  65 .SH 属性
  66 .SS "マルチスレッディング (pthreads(7) 参照)"
  67 関数 \fBmbsinit\fP() はスレッドセーフである。
  68 .SH 準拠
  69 C99.
  70 .SH 注意
  71 \fBmbsinit\fP()  の動作は現在のロケールの \fBLC_CTYPE\fP カテゴリーに依存している。
  72 .SH 関連項目
  73 \fBmbrlen\fP(3), \fBmbrtowc\fP(3), \fBwcrtomb\fP(3), \fBmbsrtowcs\fP(3), \fBwcsrtombs\fP(3)
  74 .SH この文書について
  75 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
  76 である。プロジェクトの説明とバグ報告に関する情報は
  77 http://www.kernel.org/doc/man\-pages/ に書かれている。