summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libcgi.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/lib/libcgi.tex')
-rw-r--r--Doc/lib/libcgi.tex38
1 files changed, 36 insertions, 2 deletions
diff --git a/Doc/lib/libcgi.tex b/Doc/lib/libcgi.tex
index 54fbd69..1c565fd 100644
--- a/Doc/lib/libcgi.tex
+++ b/Doc/lib/libcgi.tex
@@ -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}