fields.php

См. документацию.

<?php
namespace Bitrix\Sale\Internals;
 
class Fields
    implements \ArrayAccess, \Iterator, \Countable
{
    protected $values = array();

    protected $changedValues = array();

    private $originalValues = array();

    private $customFields = array();

    protected $isClone = false;
 
 
    public function __construct(array $values = null)
    {
        if ($values !== null)
            $this->values = $values;
    }

    public function isChanged($name)
    {
        return isset($this->changedValues[$name]);
    }

    public function get($name)
    {
        if (isset($this->values[$name]))
        {
            return $this->values[$name];
        }
 
        return null;
    }

    public function markCustom(string $field)
    {
        $this->customFields[$field] = true;
    }

    public function isMarkedCustom(string $field) : bool
    {
        if (!isset($this->customFields[$field]))
        {
            return false;
        }
 
        return $this->customFields[$field];
    }

    public function unmarkCustom(string $field)
    {
        $this->customFields[$field] = false;
    }

    public function set($name, $value)
    {
        if ($this->markChanged($name, $value))
        {
            $this->values[$name] = $value;
            return true;
        }
 
        return false;
    }

    public function init($name, $value)
    {
        $this->values[$name] = $value;
        return true;
    }
 
 
    public function clear()
    {
        $this->values = array();
        $this->clearChanged();
    }
 
    public function clearChanged()
    {
        $this->changedValues = array();
        $this->originalValues = array();
    }

    public function getValues()
    {
        return $this->values;
    }

    public function getOriginalValues()
    {
        return $this->originalValues;
    }

    public function setValues(array $values)
    {
        foreach ($values as $name => $value)
            $this->set($name, $value);
    }

    public function resetValues(array $values)
    {
        $this->values = array();
        if ($values !== null)
            $this->values = $values;
    }

    protected function markChanged($name, $value)
    {
        $originalValuesIndex = array();
        if (!empty($this->originalValues))
        {
            foreach(array_keys($this->originalValues) as $originalKey)
            {
                $originalValuesIndex[$originalKey] = true;
            }
        }
 
        $oldValue = $this->get($name);
        if ($oldValue != $value || ($oldValue === null && $value !== null))
        {
            if (!isset($originalValuesIndex[$name]))
            {
                $this->originalValues[$name] = $this->get($name);
            }
            elseif ($this->originalValues[$name] == $value)
            {
                unset($this->changedValues[$name]);
                unset($this->originalValues[$name]);
                return true;
            }
 
            $this->changedValues[$name] = true;
            return true;
        }
 
        return false;
    }

    public function getChangedKeys()
    {
        return array_keys($this->changedValues);
    }

    public function getChangedValues()
    {
        $r = array();
        foreach ($this->values as $k => $v)
        {
            if (isset($this->changedValues[$k]))
                $r[$k] = $v;
        }
        return $r;
    }

    #[\ReturnTypeWillChange]
    public function current()
    {
        return current($this->values);
    }

    public function next(): void
    {
        next($this->values);
    }

    #[\ReturnTypeWillChange]
    public function key()
    {
        return key($this->values);
    }

    public function valid(): bool
    {
        $key = $this->key();
        return ($key != null);
    }

    public function rewind(): void
    {
        reset($this->values);
    }

    public function offsetExists($offset): bool
    {
        return isset($this->values[$offset]) || array_key_exists($offset, $this->values);
    }

    #[\ReturnTypeWillChange]
    public function offsetGet($offset)
    {
        return $this->get($offset);
    }

    public function offsetSet($offset, $value): void
    {
        $this->set($offset, $value);
    }

    public function offsetUnset($offset): void
    {
        unset($this->values[$offset]);
        if (isset($this->changedValues[$offset]))
            unset($this->changedValues[$offset]);
    }

    public function count(): int
    {
        return count($this->values);
    }

    public function createClone(\SplObjectStorage $cloneEntity): Fields
    {
        if ($this->isClone() && $cloneEntity->contains($this))
        {
            return $cloneEntity[$this];
        }
 
        $fieldsClone = clone $this;
        $fieldsClone->isClone = true;
 
        if (!$cloneEntity->contains($this))
        {
            $cloneEntity[$this] = $fieldsClone;
        }
 
        return $fieldsClone;
    }

    public function isClone()
    {
        return $this->isClone;
    }
}