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


require_once 'HTML/QuickForm.php';

mixed HTML_QuickForm::exportValue ( string $element )


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.


string $element

Name of the element

Return value

return element value


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


since 3.1

This function can not be called statically.

Tells whether the form was already submitted (Previous) Returns "safe" elements' values (Next)
Last updated: Sat, 16 Feb 2019 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report.
View this page in:
  • English

User Notes:

There are no user contributed notes for this page.