caisse-bliss/vendor/symfony/form/Util/OrderedHashMapIterator.php

145 lines
3.8 KiB
PHP

<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Component\Form\Util;
/**
* Iterator for {@link OrderedHashMap} objects.
*
* @author Bernhard Schussek <bschussek@gmail.com>
*
* @internal
*
* @template-covariant TKey of array-key
* @template-covariant TValue
*
* @implements \Iterator<TKey, TValue>
*/
class OrderedHashMapIterator implements \Iterator
{
/** @var array<TKey, TValue> */
private array $elements;
/** @var list<TKey> */
private array $orderedKeys;
private int $cursor = 0;
private int $cursorId;
/** @var array<int, int> */
private array $managedCursors;
/** @var TKey|null */
private string|int|null $key = null;
/** @var TValue|null */
private mixed $current = null;
/**
* @param array<TKey, TValue> $elements The elements of the map, indexed by their
* keys
* @param list<TKey> $orderedKeys The keys of the map in the order in which
* they should be iterated
* @param array<int, int> $managedCursors An array from which to reference the
* iterator's cursor as long as it is alive.
* This array is managed by the corresponding
* {@link OrderedHashMap} instance to support
* recognizing the deletion of elements.
*/
public function __construct(array &$elements, array &$orderedKeys, array &$managedCursors)
{
$this->elements = &$elements;
$this->orderedKeys = &$orderedKeys;
$this->managedCursors = &$managedCursors;
$this->cursorId = \count($managedCursors);
$this->managedCursors[$this->cursorId] = &$this->cursor;
}
public function __sleep(): array
{
throw new \BadMethodCallException('Cannot serialize '.__CLASS__);
}
public function __wakeup()
{
throw new \BadMethodCallException('Cannot unserialize '.__CLASS__);
}
/**
* Removes the iterator's cursors from the managed cursors of the
* corresponding {@link OrderedHashMap} instance.
*/
public function __destruct()
{
// Use array_splice() instead of unset() to prevent holes in the
// array indices, which would break the initialization of $cursorId
array_splice($this->managedCursors, $this->cursorId, 1);
}
/**
* {@inheritdoc}
*/
public function current(): mixed
{
return $this->current;
}
/**
* {@inheritdoc}
*/
public function next(): void
{
++$this->cursor;
if (isset($this->orderedKeys[$this->cursor])) {
$this->key = $this->orderedKeys[$this->cursor];
$this->current = $this->elements[$this->key];
} else {
$this->key = null;
$this->current = null;
}
}
/**
* {@inheritdoc}
*/
public function key(): mixed
{
if (null === $this->key) {
return null;
}
$array = [$this->key => null];
return key($array);
}
/**
* {@inheritdoc}
*/
public function valid(): bool
{
return null !== $this->key;
}
/**
* {@inheritdoc}
*/
public function rewind(): void
{
$this->cursor = 0;
if (isset($this->orderedKeys[0])) {
$this->key = $this->orderedKeys[0];
$this->current = $this->elements[$this->key];
} else {
$this->key = null;
$this->current = null;
}
}
}