form_set_value
includes/form.inc, строка 1313
- Версии
- 5
form_set_value($form, $value)- 6
form_set_value($form_item, $value, &$form_state)
Изменяет отправленные значения формы во время цикла обработки формы.
Используйте эту функцию для изменения отправленного значения элемента формы во время фазы валидации, чтобы оно сохранилось в $form_state до фазы обработки и попало в обработчики.
Since $form_state['values'] can either be a flat array of values, or a tree
of nested values, some care must be taken when using this function.
Specifically, $form_item['#parents'] is an array that describes the branch of
the tree whose value should be updated. For example, if we wanted to update
$form_state['values']['one']['two'] to 'new value', we'd pass in
$form_item['#parents'] = array('one', 'two') and $value = 'new value'.
Параметры
$form_item
The form item that should have its value updated. Keys used: #parents,
#value. In most cases you can just pass in the right element from the $form
array.
$value
The new value for the form item.
$form_state
The array where the value change should be recorded.
Связанные темы
Код
<?php
function form_set_value($form_item, $value, &$form_state) {
_form_set_value($form_state['values'], $form_item, $form_item['#parents'], $value);
}
?>