4.4.1.1 Field class
Keywords: modpython

###
4.4.1.1 Field class

class `Field`()
  This class is used internally by `FieldStorage` and is not meant to be instantiated by the user. Each instance of a `Field` class represents an HTML Form input.

`Field` instances have the following attributes:

`name`
  The input name.

`value`
  The input value. This attribute can be used to read data from a file upload as well, but one has to excercise caution when dealing with large files since when accessed via `value`, the whole file is read into memory.

`file`
  This is a file object. For file uploads it points to a temporary file. For simple values, it is a `StringIO` object, so you can read simple string values via this attribute instead of using the `value` attribute as well.

`filename`
  The name of the file as provided by the client.

`type`
  The content-type for this input as provided by the client.

`type_opyions`
  This is what follows the actual content type in the `content-type` header provided by the client, if anything. This is a dictionary.

`disposition`
  The value of the first part of the `content-disposition` header.

`disposition_options`
  The second part (if any) of the `content-disposition` header in the form of a dictionary.

See Also:

RFC 1867, Form-based File Upload in HTML
  for a description of form-based file uploads