function form_options_flatten

7.x form_options_flatten($array)
5.x form_options_flatten($array, $reset = TRUE)
6.x form_options_flatten($array, $reset = TRUE)
8.x form_options_flatten($array)

Allows PHP array processing of multiple select options with the same value.

Used for form select elements which need to validate HTML option groups and multiple options which may return the same value. Associative PHP arrays cannot handle these structures, since they share a common key.


$array: The form options array to process.

Return value

An array with all hierarchical elements flattened to a single array.

Related topics

3 calls to form_options_flatten()
node_filter_form_submit in drupal/modules/node/
Form submission handler for node_filter_form().
user_filter_form_submit in drupal/modules/user/
Process result from user administration filter form.
_form_validate in drupal/includes/
Performs validation on form elements.


drupal/includes/, line 2583
Functions for form and batch generation and processing.


function form_options_flatten($array) {
  // Always reset static var when first entering the recursion.
  return _form_options_flatten($array);