| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179 |
- <?php
- namespace PhpOffice\PhpSpreadsheet;
- /**
- * @template T of IComparable
- */
- class HashTable
- {
- /**
- * HashTable elements.
- *
- * @var array<string, T>
- */
- protected $items = [];
- /**
- * HashTable key map.
- *
- * @var array<int, string>
- */
- protected $keyMap = [];
- /**
- * Create a new HashTable.
- *
- * @param T[] $source Optional source array to create HashTable from
- */
- public function __construct($source = null)
- {
- if ($source !== null) {
- // Create HashTable
- $this->addFromSource($source);
- }
- }
- /**
- * Add HashTable items from source.
- *
- * @param T[] $source Source array to create HashTable from
- */
- public function addFromSource(?array $source = null): void
- {
- // Check if an array was passed
- if ($source === null) {
- return;
- }
- foreach ($source as $item) {
- $this->add($item);
- }
- }
- /**
- * Add HashTable item.
- *
- * @param T $source Item to add
- */
- public function add(IComparable $source): void
- {
- $hash = $source->getHashCode();
- if (!isset($this->items[$hash])) {
- $this->items[$hash] = $source;
- $this->keyMap[count($this->items) - 1] = $hash;
- }
- }
- /**
- * Remove HashTable item.
- *
- * @param T $source Item to remove
- */
- public function remove(IComparable $source): void
- {
- $hash = $source->getHashCode();
- if (isset($this->items[$hash])) {
- unset($this->items[$hash]);
- $deleteKey = -1;
- foreach ($this->keyMap as $key => $value) {
- if ($deleteKey >= 0) {
- $this->keyMap[$key - 1] = $value;
- }
- if ($value == $hash) {
- $deleteKey = $key;
- }
- }
- unset($this->keyMap[count($this->keyMap) - 1]);
- }
- }
- /**
- * Clear HashTable.
- */
- public function clear(): void
- {
- $this->items = [];
- $this->keyMap = [];
- }
- /**
- * Count.
- *
- * @return int
- */
- public function count()
- {
- return count($this->items);
- }
- /**
- * Get index for hash code.
- *
- * @return false|int Index
- */
- public function getIndexForHashCode(string $hashCode)
- {
- return array_search($hashCode, $this->keyMap, true);
- }
- /**
- * Get by index.
- *
- * @return null|T
- */
- public function getByIndex(int $index)
- {
- if (isset($this->keyMap[$index])) {
- return $this->getByHashCode($this->keyMap[$index]);
- }
- return null;
- }
- /**
- * Get by hashcode.
- *
- * @return null|T
- */
- public function getByHashCode(string $hashCode)
- {
- if (isset($this->items[$hashCode])) {
- return $this->items[$hashCode];
- }
- return null;
- }
- /**
- * HashTable to array.
- *
- * @return T[]
- */
- public function toArray()
- {
- return $this->items;
- }
- /**
- * Implement PHP __clone to create a deep clone, not just a shallow copy.
- */
- public function __clone()
- {
- $vars = get_object_vars($this);
- foreach ($vars as $key => $value) {
- // each member of this class is an array
- if (is_array($value)) {
- $array1 = $value;
- foreach ($array1 as $key1 => $value1) {
- if (is_object($value1)) {
- $array1[$key1] = clone $value1;
- }
- }
- $this->$key = $array1;
- }
- }
- }
- }
|