# 3.7 `UserDict` -- 辞書オブジェクトのためのクラスラッパー

注意: このモジュールは後方互換性のためだけに残されています。Python 2.2より前のバージョンのPythonで動作する必要のないコードを書いているのならば、組み込み`dict`型から直接サブクラス化することを検討してください。

このモジュールは辞書オブジェクトのラッパーとして働くクラスを定義します。独自の辞書に似たクラスのために役に立つ基底クラスで、これを継承し既存のメソッドをオーバーライドしたり、あるいは、新しいものを追加したりすることができます。このような方法で、辞書に新しい振る舞いを追加できます。

最小限のマッピングインターフェイスをすでに持っているクラスのために、モジュールはすべての辞書メソッドを定義しているmixinも定義しています。これによって、shelveモジュールのような辞書の代わりをする必要があるクラスを書くことが非常に簡単になります。

`UserDict`モジュールは`UserDict`クラスと`DictMixin`を定義しています:

class `UserDict`( | [initialdata])

  辞書をシミュレートするクラス。インスタンスの内容は通常の辞書に保存され、`UserDict`インスタンスの`data`属性を通してアクセスできます。initialdataが与えられれば、`data`はその内容で初期化されます。他の目的のために使えるように、initialdataへの参照が保存されないことがあるということに注意してください。

マッピングのメソッドと演算(節2.3.7を参照)に加えて、`UserDict`インスタンスは次の属性を提供します:

`data`
  `UserDict`クラスの内容を保存するために使われる実際の辞書。

class `DictMixin`( | )

  `__getitem__`、`__setitem__`、`__delitem__`および`keys` といった最小の辞書インタフェースを既に持っているクラスのために、全ての辞書メソッドを定義する mixin です。

  このmixinはスーパークラスとして使われるべきです。上のそれぞれのメソッドを 追加することで、より多くの機能がだんだん追加されます。 例えば、`__delitem__` 以外の全てのメソッドを定義すると、使えないのは `pop`と`popitem` だけになります。

  4 つの基底メソッドに加えて、`__contains__`、`__iter__` および`iteritems`を定義すれば、順次効率化を果たすことができます。

  mixin はサブクラスのコンストラクタについて何も知らないので、 `__init__()` や `copy()` は定義していません。