Same name and namespace in other branches
  1. 5.x includes/form.inc \form_set_value()
  2. 6.x includes/form.inc \form_set_value()
  3. 7.x includes/form.inc \form_set_value()

Use this function to make changes to form values in the form validate phase, so they will be available in the submit phase in $form_values.

Specifically, if $form['#parents'] is array('foo', 'bar') and $value is 'baz' then this function will make $form_values['foo']['bar'] to be 'baz'.

Parameters

$form: The form item. Keys used: #parents, #value

$value: The value for the form item.

Related topics

4 calls to form_set_value()
form_builder in includes/form.inc
Adds some required properties to each form element, which are used internally in the form api. This function also automatically assigns the value property from the $edit array, provided the element doesn't already have an assigned value.
node_search_validate in modules/node.module
Form API callback for the search form. Registered in node_form_alter().
password_confirm_validate in includes/form.inc
Validate password_confirm element.
search_form_validate in modules/search.module
As the search form collates keys from other modules hooked in via hook_form_alter, the validation takes place in _submit. search_form_validate() is used solely to set the 'processed_keys' form value for the basic search form.

File

includes/form.inc, line 486

Code

function form_set_value($form, $value) {
  global $form_values;
  _form_set_value($form_values, $form, $form['#parents'], $value);
}