Patch by Jim Fulton to document the new parse_qls().

This commit is contained in:
Guido van Rossum 1999-06-10 03:11:41 +00:00
parent 2073177e01
commit 66ab4e8af2
1 changed files with 36 additions and 2 deletions

View File

@ -191,9 +191,43 @@ Parse a query in the environment or from a file (default
\code{sys.stdin}).
\end{funcdesc}
\begin{funcdesc}{parse_qs}{qs}
\begin{funcdesc}{parse_qs}{qs\optional{, keep_blank_values, strict_parsing}}
Parse a query string given as a string argument (data of type
\mimetype{application/x-www-form-urlencoded}).
\mimetype{application/x-www-form-urlencoded}). Data are
returned as a dictionary. The dictionary keys are the unique query
variable names and the values are lists of vales for each name.
The optional argument \var{keep_blank_values} is
a flag indicating whether blank values in
URL encoded queries should be treated as blank strings.
A true value indicates that blanks should be retained as
blank strings. The default false value indicates that
blank values are to be ignored and treated as if they were
not included.
The optional argument \var{strict_parsing} is a flag indicating what
to do with parsing errors. If false (the default), errors
are silently ignored. If true, errors raise a ValueError
exception.
\end{funcdesc}
\begin{funcdesc}{parse_qsl}{qs\optional{, keep_blank_values, strict_parsing}}
Parse a query string given as a string argument (data of type
\mimetype{application/x-www-form-urlencoded}). Data are
returned as a list of name, value pairs.
The optional argument \var{keep_blank_values} is
a flag indicating whether blank values in
URL encoded queries should be treated as blank strings.
A true value indicates that blanks should be retained as
blank strings. The default false value indicates that
blank values are to be ignored and treated as if they were
not included.
The optional argument \var{strict_parsing} is a flag indicating what
to do with parsing errors. If false (the default), errors
are silently ignored. If true, errors raise a ValueError
exception.
\end{funcdesc}
\begin{funcdesc}{parse_multipart}{fp, pdict}