PEAR Manual
Prev |  | Next

# HTML_QuickForm::exportValue()

HTML_QuickForm::exportValue() -- Returns the element's "safe" value

## Synopsis

    require_once 'HTML/QuickForm.php';

``mixed HTML_QuickForm::exportValue` (string $element)`

## Description

This method first tries to find a cleaned-up submitted value, it will return a value set by setValue()/setDefaults()/setConstants() if submitted value does not exist for the given element.

The value that couldn't have possibly been submitted (e.g.: an option that is not present in <select> element's option list) is not considered valid and is not returned.

As the values returned by this method and by exportValues() are expected to be immediately processed and/or stored somewhere, values for file elements that obviously have special processing needs are not returned.

## Parameter

string `$element`

  Name of the element

## Return value

return element value

## Throws

Table 41-1. Possible PEAR_Error values

Error code | Error message | Reason | Solution
--- | --- | --- | ---
`QUICKFORM_NONEXIST_ELEMENT` | Element '`$element`' does not exist in HTML_QuickForm::exportValue() | Tried to get a value of a non-existant element | Check the element's name spelling

## Note

since 3.1

This function can not be called statically.

Prev | Home | Next
HTML_QuickForm::setDefaults() | Up | HTML_QuickForm::exportValues()