function FieldItemList::equals

Same name in other branches
  1. 8.9.x core/lib/Drupal/Core/Field/FieldItemList.php \Drupal\Core\Field\FieldItemList::equals()
  2. 10 core/lib/Drupal/Core/Field/FieldItemList.php \Drupal\Core\Field\FieldItemList::equals()
  3. 11.x core/lib/Drupal/Core/Field/FieldItemList.php \Drupal\Core\Field\FieldItemList::equals()

Overrides FieldItemListInterface::equals

1 call to FieldItemList::equals()
FieldItemList::hasAffectingChanges in core/lib/Drupal/Core/Field/FieldItemList.php
Determines whether the field has relevant changes.
2 methods override FieldItemList::equals()
LayoutSectionItemList::equals in core/modules/layout_builder/src/Field/LayoutSectionItemList.php
Determines equality to another object implementing FieldItemListInterface.
MapFieldItemList::equals in core/lib/Drupal/Core/Field/MapFieldItemList.php
Determines equality to another object implementing FieldItemListInterface.

File

core/lib/Drupal/Core/Field/FieldItemList.php, line 371

Class

FieldItemList
Represents an entity field; that is, a list of field item objects.

Namespace

Drupal\Core\Field

Code

public function equals(FieldItemListInterface $list_to_compare) {
    $count1 = count($this);
    $count2 = count($list_to_compare);
    if ($count1 === 0 && $count2 === 0) {
        // Both are empty we can safely assume that it did not change.
        return TRUE;
    }
    if ($count1 !== $count2) {
        // One of them is empty but not the other one so the value changed.
        return FALSE;
    }
    $value1 = $this->getValue();
    $value2 = $list_to_compare->getValue();
    if ($value1 === $value2) {
        return TRUE;
    }
    // If the values are not equal ensure a consistent order of field item
    // properties and remove properties which will not be saved.
    $property_definitions = $this->getFieldDefinition()
        ->getFieldStorageDefinition()
        ->getPropertyDefinitions();
    $non_computed_properties = array_filter($property_definitions, function (DataDefinitionInterface $property) {
        return !$property->isComputed();
    });
    $callback = function (&$value) use ($non_computed_properties) {
        if (is_array($value)) {
            $value = array_intersect_key($value, $non_computed_properties);
            // Also filter out properties with a NULL value as they might exist in
            // one field item and not in the other, depending on how the values are
            // set. Do not filter out empty strings or other false-y values as e.g.
            // a NULL or FALSE in a boolean field is not the same.
            $value = array_filter($value, function ($property) {
                return $property !== NULL;
            });
            ksort($value);
        }
    };
    array_walk($value1, $callback);
    array_walk($value2, $callback);
    return $value1 == $value2;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.