Class MultiValueDict
A subclass of dictionary customized to handle multiple values for the same key.
Declaration
class MultiValueDict(dict)
source linkDocumentation
>>> d = MultiValueDict({'name': ['Adrian', 'Simon'], 'position': ['Developer']})
>>> d['name']
'Simon'
>>> d.getlist('name')
['Adrian', 'Simon']
>>> d.getlist('doesnotexist')
[]
>>> d.getlist('doesnotexist', ['Adrian', 'Simon'])
['Adrian', 'Simon']
>>> d.get('lastname', 'nonexistent')
'nonexistent'
>>> d.setlist('lastname', ['Holovaty', 'Willison'])
This class exists to solve the irritating problem raised by cgi.parse_qs,
which returns a list for every key, even though most Web forms submit
single name-value pairs.Methods
Overrides
This method is overriden in:
Overrides
This method is overriden in:
▷ def __getitem__(self, key) Return the last data value for this key, or [] if it's an empty list; raise KeyError if not found.
▶ def __init__(self, key_to_list_mapping=()) Overrides
This method is overriden in:
Overrides
This method is overriden in:
▶ def appendlist(self, key, value) Append an item to the internal list associated with key.
Overrides
This method is overriden in:
▶ def copy(self) Return a shallow copy of this object.
Overrides
This method is overriden in:
▷ def dict(self) Return current object as a dict with singular values.
▷ def get(self, key, default=None) Return the last data value for the passed key. If key doesn't exist or value is an empty list, return `default`.
▷ def getlist(self, key, default=None) Return the list of values for the key. If key doesn't exist, return a default value.
▷ def items(self) Yield (key, value) pairs, where value is the last item in the list associated with the key.
▷ def lists(self) Yield (key, list) pairs.
Overrides
This method is overriden in:
Overrides
This method is overriden in:
Overrides
This method is overriden in:
▷ def update(self, *args, **kwargs) Extend rather than replace existing key lists.
▷ def values(self) Yield the last value on every key list.
Subclasses
Reexports