1
0
mirror of https://github.com/django/django.git synced 2025-10-28 16:16:12 +00:00

[1.6.x] Improved documentation for QueryDict.

Backport of 7f4e2ef1e9 from master
This commit is contained in:
Duncan Parkes
2014-06-11 21:41:25 +01:00
committed by Tim Graham
parent e4670d988a
commit 20a1c07ea1
2 changed files with 38 additions and 18 deletions

View File

@@ -265,12 +265,19 @@ class HttpRequest(object):
class QueryDict(MultiValueDict):
"""
A specialized MultiValueDict that takes a query string when initialized.
This is immutable unless you create a copy of it.
A specialized MultiValueDict which represents a query string.
Values retrieved from this class are converted from the given encoding
A QueryDict can be used to represent GET or POST data. It subclasses
MultiValueDict since keys in such data can be repeated, for instance
in the data from a form with a <select multiple> field.
By default QueryDicts are immutable, though the copy() method
will always return a mutable copy.
Both keys and values set on this class are converted from the given encoding
(DEFAULT_CHARSET by default) to unicode.
"""
# These are both reset in __init__, but is specified here at the class
# level so that unpickling will have valid values
_mutable = True