function _field_filter_items

Helper function to filter out empty field values.

Treat this as a public function. Multiple modules have been treating it as such.

Parameters

array $field: The field definition.

array $items: The field values to filter.

array|null $instance: The field API instance definition.

Return value

array: The array of items without empty field values. The function also renumbers the array keys to ensure sequential deltas.

Related topics

File

core/modules/field/field.module, line 785

Attach custom data fields to Backdrop entities.

Code

function _field_filter_items($field, $items, $instance = NULL) {
  $function = $field['module'] . '_field_is_empty';
  foreach ((array) $items as $delta => $item) {
    // Explicitly break if the function is undefined.
    if ($function($item, $field, $instance)) {
      unset($items[$delta]);
    }
  }
  return array_values($items);
}