PHP 8.0 新特性: WeakMap 类
简介
WeakMap 是将对象作为 key 来访问的 map(或者说字典)。然而,与其它类似 SplObjectStorage 不同,WeakMap 中的对象 key 不影响对象的引用计数。也就是说,如果在任何时候对其唯一的剩余引用是 WeakMap key,那么该对象将会被垃圾收集并从 WeakMap 移除。它的主要用法是从对象中编译数据派生缓存,这种场景下不需要存活得比对象更久。
WeakMap 实现了 ArrayAccess、 Iterator、Countable, 因此大多数情况下,它能和关联数组一样使用。
类摘要
final class WeakMap implements ArrayAccess, Countable, IteratorAggregate {
/* 方法 */
public __construct()
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
}
用法示例
<?php
$wm = new WeakMap();
$o = new StdClass;
class A {
public function __destruct() {
echo "Dead!\n";
}
}
$wm[$o] = new A;
var_dump(count($wm));
echo "Unsetting...\n";
unset($o);
echo "Done\n";
var_dump(count($wm));
以上例程会输出:
int(1)
Unsetting...
Dead!
Done
int(0)
目录
- WeakMap::__construct — 实例化一个新的 map
- WeakMap::count — 统计 map 中存活实体的数量
- WeakMap::getIterator — 接收一个外部迭代器
- WeakMap::offsetExists — 检测 map 中是否存在某个对象
- WeakMap::offsetGet — 返回某个对象指向的值
- WeakMap::offsetSet — 更新 map 新的键值对
- WeakMap::offsetUnset — 从 map 中移除一条