GenericArrayObject.php

Go to the documentation of this file.

<?php
 
abstract class GenericArrayObject extends ArrayObject {
    abstract public function getObjectType();
 
    protected $indexOffset = 0;
 
    protected function getNewOffset() {
        while ( $this->offsetExists( $this->indexOffset ) ) {
            $this->indexOffset++;
        }
 
        return $this->indexOffset;
    }
 
    public function __construct( $input = null, $flags = 0, $iterator_class = 'ArrayIterator' ) {
        parent::__construct( [], $flags, $iterator_class );
 
        if ( $input !== null ) {
            foreach ( $input as $offset => $value ) {
                $this->offsetSet( $offset, $value );
            }
        }
    }
 
    public function append( $value ): void {
        $this->setElement( null, $value );
    }
 
    public function offsetSet( $index, $value ): void {
        $this->setElement( $index, $value );
    }
 
    protected function hasValidType( $value ) {
        $class = $this->getObjectType();
        return $value instanceof $class;
    }
 
    protected function setElement( $index, $value ) {
        if ( !$this->hasValidType( $value ) ) {
            throw new InvalidArgumentException(
                'Can only add ' . $this->getObjectType() . ' implementing objects to '
                . static::class . '.'
            );
        }
 
        $index ??= $this->getNewOffset();
 
        if ( $this->preSetElement( $index, $value ) ) {
            parent::offsetSet( $index, $value );
        }
    }
 
    protected function preSetElement( $index, $value ) {
        return true;
    }
 
    public function __serialize(): array {
        return $this->getSerializationData();
    }
 
    protected function getSerializationData() {
        return [
            'data' => $this->getArrayCopy(),
            'index' => $this->indexOffset,
        ];
    }
 
    public function __unserialize( $serializationData ): void {
        foreach ( $serializationData['data'] as $offset => $value ) {
            // Just set the element, bypassing checks and offset resolving,
            // as these elements have already gone through this.
            parent::offsetSet( $offset, $value );
        }
 
        $this->indexOffset = $serializationData['index'];
    }
 
    public function isEmpty() {
        return $this->count() === 0;
    }
}