7.9. "unicodedata" --- Unicode データベース
*******************************************

このモジュールは、全ての Unicode 文字の属性を定義している Unicode 文字
データベースへのアクセスを提供します。このデータベース内のデータは、
ftp://ftp.unicode.org/ で公開されている "UnicodeData.txt" ファイルのバ
ージョン 5.2.0 に基づいています。

このモジュールは、UnicodeData ファイルフォーマット 5.2.0
(http://www.unicode.org/reports/tr44/tr44-4.html を参照) で定義されて
いるものと、同じ名前と記号を使います。このモジュールで定義されている関
数は、以下のとおりです。

unicodedata.lookup(name)

   名前に対応する文字を探します。その名前の文字が見つかった場合、その
   Unicode 文字が返されます。見つからなかった場合には、 "KeyError" を
   発生させます。

unicodedata.name(unichr[, default])

   Unicode 文字 *unichr* に付いている名前を、文字列で返します。名前が
   定義されていない場合には *default* が返されますが、この引数が与えら
   れていなければ "ValueError" を発生させます。

unicodedata.decimal(unichr[, default])

   Unicode 文字 *unichr* に割り当てられている十進数を、整数で返します
   。この値が定義されていない場合には *default* が返されますが、この引
   数が与えられていなければ "ValueError" を発生させます。

unicodedata.digit(unichr[, default])

   Unicode 文字 *unichr* に割り当てられている二進数を、整数で返します
   。この値が定義されていない場合には *default* が返されますが、この引
   数が与えられていなければ "ValueError" を発生させます。

unicodedata.numeric(unichr[, default])

   Unicode 文字 *unichr* に割り当てられている数値を、float 型で返しま
   す。この値が定義されていない場合には *default* が返されますが、この
   引数が与えられていなければ "ValueError" を発生させます。

unicodedata.category(unichr)

   Unicode 文字 *unichr* に割り当てられた、汎用カテゴリを返します。

unicodedata.bidirectional(unichr)

   Unicode 文字 *unichr* に割り当てられた、双方向クラスを返します。そ
   のような値が定義されていない場合、空の文字列が返されます。

unicodedata.combining(unichr)

   Unicode 文字 *unichr* に割り当てられた正規結合クラスを返します。結
   合クラス定義されていない場合、 "0" が返されます。

unicodedata.east_asian_width(unichr)

   Unicode 文字 *unichr* に割り当てられた east asian width を文字列で
   返します。

   バージョン 2.4 で追加.

unicodedata.mirrored(unichr)

   Unicode 文字 *unichr* に割り当てられた、鏡像化のプロパティを返しま
   す。その文字が双方向テキスト内で鏡像化された文字である場合には "1"
   を、それ以外の場合には "0" を返します。

unicodedata.decomposition(unichr)

   Unicode 文字 *unichr* に割り当てられた、文字分解マッピングを、文字
   列型で返します。そのようなマッピングが定義されていない場合、空の文
   字列が返されます。

unicodedata.normalize(form, unistr)

   Unicode 文字列 *unistr* の正規形 *form* を返します。 *form* の有効
   な値は、'NFC'、'NFKC'、'NFD'、'NFKD' です。

   Unicode 規格は標準等価性 (canonical equivalence) と互換等価性
   (compatibility equivalence) に基づいて、様々な Unicode文字列の正規
   形を定義します。Unicode では、複数の方法で表現できる文字があります
   。たとえば、文字 U+00C7 (LATIN CAPITAL LETTER C WITH CEDILLA) は、
   U+0043 (LATIN CAPITAL LETTER C) U+0327 (COMBINING CEDILLA) というシ
   ーケンスとしても表現できます。

   各文字には2つの正規形があり、それぞれ正規形 C と正規形 D といいます
   。正規形 D (NFD) は標準分解 (canonical decomposition) としても知ら
   れており、各文字を分解された形に変換します。正規形 C (NFC) は標準分
   解を適用した後、結合済文字を再構成します。

   互換等価性に基づいて、2つの正規形が加えられています。Unicode では、
   一般に他の文字との統合がサポートされている文字があります。たとえば
   、U+2160 (ROMAN NUMERAL ONE) は事実上 U+0049 (LATIN CAPITAL LETTER
   I) と同じものです。しかし、Unicode では、既存の文字集合 (たとえば
   gb2312) との互換性のために、これがサポートされています。

   正規形 KD (NFKD) は、互換分解 (compatibility decomposition) を適用
   します。すなわち、すべての互換文字を、等価な文字で置換します。正規
   形 KC (NFKC) は、互換分解を適用してから、標準分解を適用します。

   2つのunicode文字列が正規化されていて人間の目に同じに見えても、片方
   が結合文字を持っていてもう片方が持っていない場合、それらは完全に同
   じではありません。

   バージョン 2.3 で追加.

更に、本モジュールは以下の定数を公開します:

unicodedata.unidata_version

   このモジュールで使われている Unicode データベースのバージョン。

   バージョン 2.3 で追加.

unicodedata.ucd_3_2_0

   これはモジュール全体と同じメソッドを具えたオブジェクトですが、
   Unicode データベースバージョン 3.2 を代わりに使っており、この特定の
   バージョンの Unicode データベースを必要とするアプリケーション(IDNA
   など)のためものです。

   バージョン 2.5 で追加.

例:

>>> import unicodedata
>>> unicodedata.lookup('LEFT CURLY BRACKET')
u'{'
>>> unicodedata.name(u'/')
'SOLIDUS'
>>> unicodedata.decimal(u'9')
9
>>> unicodedata.decimal(u'a')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: not a decimal
>>> unicodedata.category(u'A')  # 'L'etter, 'u'ppercase
'Lu'
>>> unicodedata.bidirectional(u'\u0660') # 'A'rabic, 'N'umber
'AN'
