form_options_flatten

  1. drupal
    1. 5
    2. 6
    3. 7
    4. 8
Versions
5 – 6 form_options_flatten($array, $reset = TRUE)
8 – 7 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.

Parameters

$array The form options array to process.

Return value

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

Related topics

▾ 3 functions call form_options_flatten()

node_filter_form_submit in modules/node/node.admin.inc
Process result from node administration filter form.
user_filter_form_submit in modules/user/user.admin.inc
Process result from user administration filter form.
_form_validate in includes/form.inc
Performs validation on form elements. First ensures required fields are completed, #maxlength is not exceeded, and selected options were in the list of options given to the user. Then calls user-defined validators.

Code

includes/form.inc, line 2450

<?php
function form_options_flatten($array) {
  // Always reset static var when first entering the recursion.
  drupal_static_reset('_form_options_flatten');
  return _form_options_flatten($array);
}
?>