Mercurial > cpython-lru_cache-weakref

diff Doc/lib/libcgi.tex @ 24935:64508a37a8d5 legacy-trunk

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Clarify that even though some of the relevant specifications define the order in which form variables should be encoded in a request, a CGI script should not rely on that since a client may not conform to those specs, or they may not be relevant to the request. Closes SF bug #596866.
author Fred Drake <fdrake@acm.org>
date Wed, 21 Aug 2002 19:24:21 +0000
parents 7c6094b18d16
children acecdc4f7333
line wrap: on
line diff
--- a/Doc/lib/libcgi.tex	Wed Aug 21 13:20:51 2002 +0000
+++ b/Doc/lib/libcgi.tex	Wed Aug 21 19:24:21 2002 +0000
@@ -204,10 +204,8 @@
 you expected a user to post more than one value under one name:
 
 \begin{verbatim}
-from types import ListType
-
 item = form.getvalue("item")
-if isinstance(item, ListType):
+if isinstance(item, list):
     # The user is requesting more than one item.
 else:
     # The user is requesting only one item.
@@ -252,10 +250,14 @@
   \var{name}.  The method returns only the first value in case that
   more values were posted under such name.  Please note that the order
   in which the values are received may vary from browser to browser
-  and should not be counted on.  If no such form field or value exists
-  then the method returns the value specified by the optional
-  parameter \var{default}.  This parameter defaults to \code{None} if
-  not specified.
+  and should not be counted on.\footnote{Note that some recent
+      versions of the HTML specification do state what order the
+      field values should be supplied in, but knowing whether a
+      request was received from a conforming browser, or even from a
+      browser at all, is tedious and error-prone.}  If no such form
+  field or value exists then the method returns the value specified by
+  the optional parameter \var{default}.  This parameter defaults to
+  \code{None} if not specified.
 \end{methoddesc}
 
 \begin{methoddesc}[FieldStorage]{getlist}{name}
@@ -270,7 +272,7 @@
 \begin{verbatim}
 import cgi
 form = cgi.FieldStorage()
-user = form.getfirst("user").toupper()    # This way it's safe.
+user = form.getfirst("user", "").toupper()    # This way it's safe.
 for item in form.getlist("item"):
     do_something(item)
 \end{verbatim}