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

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

2 calls to form_options_flatten()
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.

File

includes/form.inc, line 2688
Functions for form and batch generation and processing.

Code

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);
}