<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="modpython.css" type='text/css' />
<link rel="first" href="modpython.html" title='Mod_python Manual' />
<link rel='contents' href='contents.html' title="Contents" />
<link rel='index' href='genindex.html' title='Index' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="pyapi-util-funcs.html" />
<link rel="prev" href="pyapi-util-fstor-examples.html" />
<link rel="parent" href="pyapi-util.html" />
<link rel="next" href="pyapi-util-funcs.html" />
<meta name='aesop' content='information' />
<title>4.6.3 Field class</title>
</head>
<body>
<DIV CLASS="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="4.6.2 FieldStorage Examples"
href="pyapi-util-fstor-examples.html"><img src='previous.png'
border='0' height='32' alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="4.6 util - Miscellaneous"
href="pyapi-util.html"><img src='up.png'
border='0' height='32' alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="4.6.4 Other functions"
href="pyapi-util-funcs.html"><img src='next.png'
border='0' height='32' alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Mod_python Manual</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
border='0' height='32' alt='Contents' width='32' /></A></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><a rel="index" title="Index"
href="genindex.html"><img src='index.png'
border='0' height='32' alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="pyapi-util-fstor-examples.html">4.6.2 FieldStorage Examples</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="pyapi-util.html">4.6 util - Miscellaneous</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="pyapi-util-funcs.html">4.6.4 Other functions</A>
</div>
<hr /></div>
</DIV>
<!--End of Navigation Panel-->
<H2><A NAME="SECTION006630000000000000000"></A><A NAME="pyapi-util-fstor-fld"></A>
<BR>
4.6.3 Field class
</H2>
<P>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
<td><nobr><b><span class="typelabel">class</span> <tt id='l2h-216' xml:id='l2h-216' class="class">Field</tt></b>(</nobr></td>
<td><var></var>)</td></tr></table></dt>
<dd>
This class is used internally by <tt class="class">FieldStorage</tt> and is not
meant to be instantiated by the user. Each instance of a <tt class="class">Field</tt>
class represents an HTML Form input.
<P>
<tt class="class">Field</tt> instances have the following attributes:
<P>
<dl><dt><b><tt id='l2h-217' xml:id='l2h-217' class="member">name</tt></b></dt>
<dd>
The input name.
</dl>
<P>
<dl><dt><b><tt id='l2h-218' xml:id='l2h-218' class="member">value</tt></b></dt>
<dd>
The input value. This attribute can be used to read data from a file
upload as well, but one has to exercise caution when dealing with
large files since when accessed via <tt class="member">value</tt>, the whole file is
read into memory.
</dl>
<P>
<dl><dt><b><tt id='l2h-219' xml:id='l2h-219' class="member">file</tt></b></dt>
<dd>
This is a file-like object. For file uploads it points to a
<tt class="class">TemporaryFile</tt> instance. (For more information see the TemporaryFile
class in the standard python
<em class="citetitle"><a
href="http://docs.python.org/lib/module-tempfile.html"
title="tempfile"
>tempfile</a></em> module).
<P>
For simple values, it is a <tt class="class">StringIO</tt> object, so you can read
simple string values via this attribute instead of using the <tt class="member">value</tt>
attribute as well.
</dl>
<P>
<dl><dt><b><tt id='l2h-220' xml:id='l2h-220' class="member">filename</tt></b></dt>
<dd>
The name of the file as provided by the client.
</dl>
<P>
<dl><dt><b><tt id='l2h-221' xml:id='l2h-221' class="member">type</tt></b></dt>
<dd>
The content-type for this input as provided by the client.
</dl>
<P>
<dl><dt><b><tt id='l2h-222' xml:id='l2h-222' class="member">type_options</tt></b></dt>
<dd>
This is what follows the actual content type in the <code>content-type</code>
header provided by the client, if anything. This is a dictionary.
</dl>
<P>
<dl><dt><b><tt id='l2h-223' xml:id='l2h-223' class="member">disposition</tt></b></dt>
<dd>
The value of the first part of the <code>content-disposition</code> header.
</dl>
<P>
<dl><dt><b><tt id='l2h-224' xml:id='l2h-224' class="member">disposition_options</tt></b></dt>
<dd>
The second part (if any) of the <code>content-disposition</code> header in
the form of a dictionary.
</dl>
<P>
<div class="seealso">
<p class="heading">See Also:</p>
<dl compact="compact" class="seerfc">
<dt><a href="http://www.faqs.org/rfcs/rfc1867.html"
title="Form-based File Upload in HTML"
>RFC 1867, <em>Form-based File Upload in HTML</em></a>
<dd>for a description of
form-based file uploads
</dl>
</div>
</dl>
<P>
<DIV CLASS="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="4.6.2 FieldStorage Examples"
href="pyapi-util-fstor-examples.html"><img src='previous.png'
border='0' height='32' alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="4.6 util - Miscellaneous"
href="pyapi-util.html"><img src='up.png'
border='0' height='32' alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="4.6.4 Other functions"
href="pyapi-util-funcs.html"><img src='next.png'
border='0' height='32' alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Mod_python Manual</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
border='0' height='32' alt='Contents' width='32' /></A></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><a rel="index" title="Index"
href="genindex.html"><img src='index.png'
border='0' height='32' alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="pyapi-util-fstor-examples.html">4.6.2 FieldStorage Examples</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="pyapi-util.html">4.6 util - Miscellaneous</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="pyapi-util-funcs.html">4.6.4 Other functions</A>
</div>
</div>
<hr />
<span class="release-info">Release 3.3.1, documentation updated on January 29, 2007.</span>
</DIV>
<!--End of Navigation Panel-->
</BODY>
</HTML>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
15533144ea879a3ee7f2cdcbb31e4859
>
files
>
123
