Returns a new empty object of type mp_table
. See Section
4.5.2 for description of the table object. The
mapping-or-sequence will be used to provide initial values for
the table.
The table object is a wrapper around the Apache APR table. The table
object behaves very much like a dictionary (including the Python 2.2
features such as support of the in
operator, etc.), with the
following differences:
- Both keys and values must be strings.
- Key lookups are case-insensitive.
- Duplicate keys are allowed (see add() below). When there is
more than one value for a key, a subscript opration returns a list.
Much of the information that Apache uses is stored in tables. For
example, req.headers_in and req.headers_out.
All the tables that mod_python provides inside the request
object are actual mappings to the Apache structures, so changing the
Python table also changes the underlying Apache table.
In addition to normal dictionary-like behavior, the table object also
has the following method:
- add(key, val)
-
add() allows for creating duplicate keys, which is useful
when multiple headers, such as
Set-Cookie:
are required.
New in version 3.0.