]> granicus.if.org Git - python/commitdiff
[Bug #953177] Mention .getlist(); text from Paul Moore
authorAndrew M. Kuchling <amk@amk.ca>
Sun, 6 Jun 2004 23:28:23 +0000 (23:28 +0000)
committerAndrew M. Kuchling <amk@amk.ca>
Sun, 6 Jun 2004 23:28:23 +0000 (23:28 +0000)
Doc/lib/libcgi.tex

index a14717ac887a849c4add01431dcf16c4106b58ff..3cb07b2da3ddadf53605b5cd8168c9b5d4158a94 100644 (file)
@@ -135,19 +135,14 @@ instance but a list of such instances.  Similarly, in this situation,
 \samp{form.getvalue(\var{key})} would return a list of strings.
 If you expect this possibility
 (when your HTML form contains multiple fields with the same name), use
-the \function{isinstance()} built-in function to determine whether you
-have a single instance or a list of instances.  For example, this
+the \function{getlist()} function, which always returns a list of values (so that you
+do not need to special-case the single item case).  For example, this
 code concatenates any number of username fields, separated by
 commas:
 
 \begin{verbatim}
-value = form.getvalue("username", "")
-if isinstance(value, list):
-    # Multiple username fields specified
-    usernames = ",".join(value)
-else:
-    # Single or no username field specified
-    usernames = value
+value = form.getlist("username")
+usernames = ",".join(value)
 \end{verbatim}
 
 If a field represents an uploaded file, accessing the value via the