<!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>