The WeakMap class

(PECL weakref >= 0.2.0)

Introduction

Class synopsis

WeakMap implements Countable , ArrayAccess , Iterator , Traversable {

/* Methods */

public __construct ( void )

public int count ( void )

public mixed current ( void )

public object key ( void )

public void next ( void )

public bool offsetExists ( object $object )

public mixed offsetGet ( object $object )

public void offsetSet ( object $object , mixed $value )

public void offsetUnset ( object $object )

public void rewind ( void )

public bool valid ( void )

}

Examples

Example #1 Weakmap usage example


<?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));

The above example will output:

int(1)
Unsetting..
Dead!
Done
int(0)

WeakMap::__construct — Constructs a new map
WeakMap::count — Counts the number of live entries in the map
WeakMap::current — Returns the current value under iteration
WeakMap::key — Returns the current key under iteration.
WeakMap::next — Advances to the next map element
WeakMap::offsetExists — Checks whether a certain object is in the map
WeakMap::offsetGet — Returns the value pointed to by a certain object
WeakMap::offsetSet — Updates the map with a new key-value pair
WeakMap::offsetUnset — Removes an entry from the map
WeakMap::rewind — Rewinds the iterator to the beginning of the map
WeakMap::valid — Returns whether the iterator is still on a valid map element

The WeakMap class

Introduction

Class synopsis

Examples

Table of Contents