4.5.2 テーブルオブジェクト (mp

4.5.2 テーブルオブジェクト (mp_table)

クラス table( [mapping-or-sequence])

mp_table 型の新たな空のオブジェクトを返します。テーブルオブジェクトの説明は4.5.2 節を参照してください。 mapping-or-sequence はテーブルの初期値設定に使われます。

テーブルオブジェクトはApache APR テーブルに対するラッパです。このテーブルオブジェクトは、(Python 2.2 からサポートされたin 演算子なども含めて) ほぼ辞書と同じようにふるまいます。ただし、以下の点で異なります:

キーと値はいずれも文字列でなければなりません。
キーの参照時に大文字と小文字を区別しません。
キーの重複があってもかまいません (add() メソッドを参照してください) 一つのキーに対して複数の値が存在する場合、添字参照 (subscript operation) を行うとリストを返します。

このテーブルには、Apache の使う多くの情報、例えばreq.headers_in や req.headers_out などが入っています。

mod_python がリクエストオブジェクトの中で提供しているテーブルは、全て Apache の構造体に対する実マッピングなので、 Python 側でテーブルを変更すると、根底にある Apache のテーブルも変更されます。

通常の辞書に似たふるまいの他に、テーブルオブジェクトには以下のメソッドがあります:

add( key, val): 重複するキーを作成できるようにします。Set-Cookie: のような、同じキーを持つ複数のヘッダが必要な場合に便利です。

バージョン 3.0 で新たに追加されました。