← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/libapache2-mod-python/jaunty

« back to all changes in this revision

Viewing changes to doc-html/pyapi-util-fstor.html

  • Committer: Bazaar Package Importer
  • Author(s): Piotr Ozarowski
  • Date: 2007-02-21 18:24:29 UTC
  • mfrom: (1.1.8 feisty)
  • Revision ID: james.westby@ubuntu.com-20070221182429-9okop7e0qpi24l85
Tags: 3.2.10-4
http://bugs.debian.org/411235
http://bugs.debian.org/411742
http://bugs.debian.org/411831
* Added XS-Vcs-Svn field
* Removed "db_purge" part from libapache2-mod-python.postrm
  (dh_installdebconf is generating a rule that will not fail if debconf is
  already removed)
* Added initial Spanish debconf translation from Manuel Porras Peralta.
  (closes: #411235)
* Added initial Portuguese debconf translation from Pedro Ribeiro.
  (closes: #411742)
* Added initial Galician debconf translation from Jacobo Tarrio.
  (closes: #411831)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc-html/pyapi-util-fstor.html
1
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2
2
<html>
3
3
<head>
4
 
<title>4.6.1 FieldStorage class</title>
5
 
<META NAME="description" CONTENT="4.6.1 FieldStorage class">
 
4
<link rel="STYLESHEET" href="modpython.css" type='text/css'>
 
5
<link rel="first" href="modpython.html" title='Mod_python Manual'>
 
6
<link rel='contents' href='contents.html' title="Contents">
 
7
<link rel='index' href='genindex.html' title='Index'>
 
8
<link rel='last' href='about.html' title='About this document...'>
 
9
<link rel='help' href='about.html' title='About this document...'>
 
10
<LINK REL="next" href="pyapi-util-fstor-examples.html">
 
11
<LINK REL="prev" href="pyapi-util.html">
 
12
<LINK REL="parent" href="pyapi-util.html">
 
13
<LINK REL="next" href="pyapi-util-fstor-examples.html">
 
14
<meta name='aesop' content='information'>
 
15
<META NAME="description" CONTENT="FieldStorage class">
6
16
<META NAME="keywords" CONTENT="modpython">
7
17
<META NAME="resource-type" CONTENT="document">
8
18
<META NAME="distribution" CONTENT="global">
9
 
<link rel="STYLESHEET" href="modpython.css">
10
 
<link rel="first" href="modpython.html">
11
 
<link rel="contents" href="contents.html" title="Contents">
12
 
<link rel="index" href="genindex.html" title="Index">
13
 
<LINK REL="next" href="pyapi-util-fstor-fld.html">
14
 
<LINK REL="previous" href="pyapi-util.html">
15
 
<LINK REL="up" href="pyapi-util.html">
16
 
<LINK REL="next" href="pyapi-util-fstor-fld.html">
 
19
<title>4.6.1 FieldStorage class</title>
17
20
</head>
18
21
<body>
19
22
<DIV CLASS="navigation">
20
23
<table align="center" width="100%" cellpadding="0" cellspacing="2">
21
24
<tr>
22
 
<td><A href="pyapi-util.html"><img src="icons/previous.gif"
23
 
  border="0" height="32"
24
 
  alt="Previous Page" width="32"></A></td>
25
 
<td><A href="pyapi-util.html"><img src="icons/up.gif"
26
 
  border="0" height="32"
27
 
  alt="Up One Level" width="32"></A></td>
28
 
<td><A href="pyapi-util-fstor-fld.html"><img src="icons/next.gif"
29
 
  border="0" height="32"
30
 
  alt="Next Page" width="32"></A></td>
 
25
<td><a rel="prev" title="4.6 util - Miscellaneous" 
 
26
  href="pyapi-util.html"><img src='previous.gif'
 
27
  border='0' height='32'  alt='Previous Page' width='32'></A></td>
 
28
<td><a rel="parent" title="4.6 util - Miscellaneous" 
 
29
  href="pyapi-util.html"><img src='up.gif'
 
30
  border='0' height='32'  alt='Up One Level' width='32'></A></td>
 
31
<td><a rel="next" title="4.6.2 FieldStorage Examples" 
 
32
  href="pyapi-util-fstor-examples.html"><img src='next.gif'
 
33
  border='0' height='32'  alt='Next Page' width='32'></A></td>
31
34
<td align="center" width="100%">Mod_python Manual</td>
32
 
<td><A href="contents.html"><img src="icons/contents.gif"
33
 
  border="0" height="32"
34
 
  alt="Contents" width="32"></A></td>
35
 
<td><img src="icons/blank.gif"
36
 
  border="0" height="32"
37
 
  alt="" width="32"></td>
38
 
<td><A href="genindex.html"><img src="icons/index.gif"
39
 
  border="0" height="32"
40
 
  alt="Index" width="32"></A></td>
 
35
<td><a rel="contents" title="Table of Contents" 
 
36
  href="contents.html"><img src='contents.gif'
 
37
  border='0' height='32'  alt='Contents' width='32'></A></td>
 
38
<td><img src='blank.gif'
 
39
  border='0' height='32'  alt='' width='32'></td>
 
40
<td><a rel="index" title="Index" 
 
41
  href="genindex.html"><img src='index.gif'
 
42
  border='0' height='32'  alt='Index' width='32'></A></td>
41
43
</tr></table>
42
 
<b class="navlabel">Previous:</b> <a class="sectref" href="pyapi-util.html">4.6 util - Miscellaneous</A>
43
 
<b class="navlabel">Up:</b> <a class="sectref" href="pyapi-util.html">4.6 util - Miscellaneous</A>
44
 
<b class="navlabel">Next:</b> <a class="sectref" href="pyapi-util-fstor-fld.html">4.6.2 Field class</A>
 
44
<b class="navlabel">Previous:</b>
 
45
<a class="sectref" rel="prev" href="pyapi-util.html">4.6 util - Miscellaneous</A>
 
46
<b class="navlabel">Up:</b>
 
47
<a class="sectref" rel="parent" href="pyapi-util.html">4.6 util - Miscellaneous</A>
 
48
<b class="navlabel">Next:</b>
 
49
<a class="sectref" rel="next" href="pyapi-util-fstor-examples.html">4.6.2 FieldStorage Examples</A>
45
50
<br><hr>
46
51
</DIV>
47
52
<!--End of Navigation Panel-->
57
62
<tt class="module">cgi</tt> <tt class="class">FieldStorage</tt>.
58
63
 
59
64
<P>
60
 
<dl><dt><b><span class="typelabel">class</span> <a name="l2h-169"><tt class="class">FieldStorage</tt></a></b>(<var>req</var><big>[</big><var>, keep_blank_values, strict_parsing</var><big>]</big>)
 
65
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
 
66
  <td><nobr><b><span class="typelabel">class</span>&nbsp;<a name="l2h-190"><tt class="class">FieldStorage</tt></a></b>(</nobr></td>
 
67
  <td><var>req</var><big>[</big><var>, keep_blank_values, strict_parsing, file_callback, field_callback</var><big>]</big>)</td></tr></table>
61
68
<dd>
62
69
  This class provides uniform access to HTML form data submitted by the
63
70
  client.  <var>req</var> is an instance of the mod_python request object.
72
79
The optional argument <var>strict_parsing</var> is not yet implemented.
73
80
 
74
81
<P>
 
82
The optional argument <var>file_callback</var> allows the application to override
 
83
  both file creation/deletion semantics and location. See
 
84
  <A href="pyapi-util-fstor-examples.html#pyapi-util-fstor-examples">4.6.2</A> ``FieldStorage Examples'' for additional
 
85
  information. <i>New in version 3.2</i>
 
86
 
 
87
<P>
 
88
The optional argument <var>field_callback</var> allows the application to override
 
89
  both the creation/deletion semantics and behaviour. <i>New in version 3.2</i>
 
90
 
 
91
<P>
75
92
During initialization, <tt class="class">FieldStorage</tt> class reads all of the
76
93
  data provided by the client. Since all data provided by the client is
77
94
  consumed at this point, there should be no more than one
99
116
    provides the additional <tt class="member">value</tt> attribute for compatibility
100
117
    with standard library <tt class="module">cgi</tt> module.
101
118
</LI>
102
 
<LI>An instances of a <tt class="class">Field</tt> class, if the input is a file upload.
 
119
<LI>An instance of a <tt class="class">Field</tt> class, if the input is a file upload.
103
120
</LI>
104
121
<LI>A list of <tt class="class">StringField</tt> and/or <tt class="class">Field</tt> objects. This is
105
122
    when multiple values exist, such as for a <code>&lt;select&gt;</code> HTML form
123
140
  have the following attributes:
124
141
 
125
142
<P>
126
 
<dl><dt><b><a name="l2h-170"><tt class="member">list</tt></a></b>
 
143
<dl><dt><b><a name="l2h-191"><tt class="member">list</tt></a></b>
127
144
<dd>
128
145
    This is a list of <tt class="class">Field</tt> objects, one for each input. Multiple
129
146
    inputs with the same name will have multiple elements in this list.
133
150
<tt class="class">FieldStorage</tt> methods:
134
151
 
135
152
<P>
136
 
<dl><dt><b><a name="l2h-171"><tt class="method">getfirst</tt></a></b>(<var>name</var><big>[</big><var>, default</var><big>]</big>)
 
153
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
 
154
  <td><nobr><b><a name="l2h-192"><tt class="method">getfirst</tt></a></b>(</nobr></td>
 
155
  <td><var>name</var><big>[</big><var>, default</var><big>]</big>)</td></tr></table>
137
156
<dd>
138
157
    Always returns only one value associated with form field
139
158
    <var>name</var>. If no such form field or value exists then the method
143
162
  </dl>
144
163
 
145
164
<P>
146
 
<dl><dt><b><a name="l2h-172"><tt class="method">getlist</tt></a></b>(<var>name</var>)
 
165
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
 
166
  <td><nobr><b><a name="l2h-193"><tt class="method">getlist</tt></a></b>(</nobr></td>
 
167
  <td><var>name</var>)</td></tr></table>
147
168
<dd>
148
169
    This method always returns a list of values associated with form
149
170
    field <var>name</var>. The method returns an empty list if no such form
160
181
<p><hr>
161
182
<table align="center" width="100%" cellpadding="0" cellspacing="2">
162
183
<tr>
163
 
<td><A href="pyapi-util.html"><img src="icons/previous.gif"
164
 
  border="0" height="32"
165
 
  alt="Previous Page" width="32"></A></td>
166
 
<td><A href="pyapi-util.html"><img src="icons/up.gif"
167
 
  border="0" height="32"
168
 
  alt="Up One Level" width="32"></A></td>
169
 
<td><A href="pyapi-util-fstor-fld.html"><img src="icons/next.gif"
170
 
  border="0" height="32"
171
 
  alt="Next Page" width="32"></A></td>
 
184
<td><a rel="prev" title="4.6 util - Miscellaneous" 
 
185
  rel="prev" title="4.6 util - Miscellaneous" 
 
186
  href="pyapi-util.html"><img src='previous.gif'
 
187
  border='0' height='32'  alt='Previous Page' width='32'></A></td>
 
188
<td><a rel="parent" title="4.6 util - Miscellaneous" 
 
189
  rel="parent" title="4.6 util - Miscellaneous" 
 
190
  href="pyapi-util.html"><img src='up.gif'
 
191
  border='0' height='32'  alt='Up One Level' width='32'></A></td>
 
192
<td><a rel="next" title="4.6.2 FieldStorage Examples" 
 
193
  rel="next" title="4.6.2 FieldStorage Examples" 
 
194
  href="pyapi-util-fstor-examples.html"><img src='next.gif'
 
195
  border='0' height='32'  alt='Next Page' width='32'></A></td>
172
196
<td align="center" width="100%">Mod_python Manual</td>
173
 
<td><A href="contents.html"><img src="icons/contents.gif"
174
 
  border="0" height="32"
175
 
  alt="Contents" width="32"></A></td>
176
 
<td><img src="icons/blank.gif"
177
 
  border="0" height="32"
178
 
  alt="" width="32"></td>
179
 
<td><A href="genindex.html"><img src="icons/index.gif"
180
 
  border="0" height="32"
181
 
  alt="Index" width="32"></A></td>
 
197
<td><a rel="contents" title="Table of Contents" 
 
198
  rel="contents" title="Table of Contents" 
 
199
  href="contents.html"><img src='contents.gif'
 
200
  border='0' height='32'  alt='Contents' width='32'></A></td>
 
201
<td><img src='blank.gif'
 
202
  border='0' height='32'  alt='' width='32'></td>
 
203
<td><a rel="index" title="Index" 
 
204
  rel="index" title="Index" 
 
205
  href="genindex.html"><img src='index.gif'
 
206
  border='0' height='32'  alt='Index' width='32'></A></td>
182
207
</tr></table>
183
 
<b class="navlabel">Previous:</b> <a class="sectref" href="pyapi-util.html">4.6 util - Miscellaneous</A>
184
 
<b class="navlabel">Up:</b> <a class="sectref" href="pyapi-util.html">4.6 util - Miscellaneous</A>
185
 
<b class="navlabel">Next:</b> <a class="sectref" href="pyapi-util-fstor-fld.html">4.6.2 Field class</A>
 
208
<b class="navlabel">Previous:</b>
 
209
<a class="sectref" rel="prev" href="pyapi-util.html">4.6 util - Miscellaneous</A>
 
210
<b class="navlabel">Up:</b>
 
211
<a class="sectref" rel="parent" href="pyapi-util.html">4.6 util - Miscellaneous</A>
 
212
<b class="navlabel">Next:</b>
 
213
<a class="sectref" rel="next" href="pyapi-util-fstor-examples.html">4.6.2 FieldStorage Examples</A>
186
214
<hr>
187
 
<span class="release-info">Release 3.1.3, documentation updated on February 17, 2004.</span>
 
215
<span class="release-info">Release 3.2.10, documentation updated on July 19, 2006.</span>
188
216
</DIV>
189
217
<!--End of Navigation Panel-->
190
218