array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'class.weakmap.php', 1 => 'WeakMap', 2 => 'Класс WeakMap', ), 'up' => array ( 0 => 'reserved.interfaces.php', 1 => 'Встроенные интерфейсы и классы', ), 'prev' => array ( 0 => 'weakreference.get.php', 1 => 'WeakReference::get', ), 'next' => array ( 0 => 'weakmap.count.php', 1 => 'WeakMap::count', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'language/predefined/weakmap.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.weakmap.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Класс WeakMap

(PHP 8)

Введение

Класс WeakMap — карта, или словарь, который принимает объекты как ключи. Однако, PHP не учитывает объект в ключе экземпляра класса WeakMap при подсчёте ссылок на объект, в отличие от аналогичного в остальном класса SplObjectStorage. Поэтому как только единственной ссылкой на объект останется ключ экземпляра класса WeakMap, сборщик мусора соберёт и удалит объект из экземпляра WeakMap. Главное назначение класса — создавать кеши данных, которые получили из объекта и которым не требуется жить дольше, чем сам объект.

Класс WeakMap реализует интерфейсы ArrayAccess, Traversable (через интерфейс IteratorAggregate) и Countable, поэтому с объектом класса часто работают так же, как с ассоциативным массивом.

Обзор класса

final class WeakMap implements ArrayAccess, Countable, IteratorAggregate {
/* Методы */
public count(): int
public getIterator(): Iterator
public offsetExists(object $object): bool
public offsetGet(object $object): mixed
public offsetSet(object $object, mixed $value): void
public offsetUnset(object $object): void
}

Примеры

Пример #1 Пример использования класса Weakmap

<?php

$wm = new WeakMap();

$o = new stdClass;

class A {
public function __destruct() {
echo "Уничтожено!\n";
}
}

$wm[$o] = new A;

var_dump(count($wm));
echo "Сброс...\n";
unset($o);
echo "Готово\n";
var_dump(count($wm));

?>

Результат выполнения приведённого примера: 

int(1)
Сброс...
Уничтожено!
Готово
int(0)

Содержание