function FieldItemList::equals

Overrides FieldItemListInterface::equals

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

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