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

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

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

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

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

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

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

クラス DictMixin( )

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

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

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

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

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。

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