5.3.3 defaultdict オブジェクト

5.3.3 `defaultdict` オブジェクト

defaultdict( [default_factory[, ...]])

新しいディクショナリ状のオブジェクトを返します。defaultdictは組込みの dictのサブクラスです。メソッドをオーバーライドし、書き込み可能なインスタンス変数を1つ追加している以外は dictクラスと同じです。同じ部分については以下では省略されています。

1つめの引数はdefault_factory属性の初期値です。デフォルトは Noneです。残りの引数はキーワード引数もふくめ、dictのコンストラクタにあたえられた場合と同様に扱われます。

バージョン 2.5 で新たに追加された仕様です。

defaultdict オブジェクトは標準のdictに加えて、以下のメソッドを実装しています:

__missing__( key)

もしdefault_factory属性がNoneであれば、このメソッドは KeyError例外を、keyを引数として発生させます。

もしdefault_factory属性がNoneでなければ、このメソッドは default_factoryを引数なしで呼び出し、あたえられたkeyに対応するデフォルト値を作ります。そしてこの値を key に対応する値を辞書に登録して返ります。

もし default_factory の呼出が例外を発生させた場合には、変更せずそのまま例外を投げます。

このメソッドはdictクラスの __getitem__ メソッドで、キーが存在しなかった場合によびだされます。値を返すか例外を発生させるのどちらにしても、__getitem__からもそのまま値が返るか例外が発生します。

defaultdict オブジェクトは以下のインスタンス変数をサポートしています:

default_factory: この属性は __missing__ メソッドによって使われます。これは存在すればコンストラクタの第1引数によって初期化され、そうでなければ Noneになります。

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