arrayaccess(3) [php man page]

ARRAYACCESS(3)								 1							    ARRAYACCESS(3)

The ArrayAccess interface

INTRODUCTION

	Interface to provide accessing objects as arrays.

INTERFACE SYNOPSIS

       ArrayAccess

       ArrayAccess

       Methods

       o abstractpublic boolean ArrayAccess::offsetExists (mixed  $offset)

       o abstractpublic mixed ArrayAccess::offsetGet (mixed  $offset)

       o abstractpublic void ArrayAccess::offsetSet (mixed  $offset, mixed  $value)

       o abstractpublic void ArrayAccess::offsetUnset (mixed  $offset)

       Example #1

	      Basic usage

	      <?php
	      class obj implements ArrayAccess {
		  private $container = array();

		  public function __construct() {
		      $this->container = array(
			  "one"   => 1,
			  "two"   => 2,
			  "three" => 3,
		      );
		  }

		  public function offsetSet($offset, $value) {
		      if (is_null($offset)) {
			  $this->container[] = $value;
		      } else {
			  $this->container[$offset] = $value;
		      }
		  }

		  public function offsetExists($offset) {
		      return isset($this->container[$offset]);
		  }

		  public function offsetUnset($offset) {
		      unset($this->container[$offset]);
		  }

		  public function offsetGet($offset) {
		      return isset($this->container[$offset]) ? $this->container[$offset] : null;
		  }
	      }

	      $obj = new obj;

	      var_dump(isset($obj["two"]));
	      var_dump($obj["two"]);
	      unset($obj["two"]);
	      var_dump(isset($obj["two"]));
	      $obj["two"] = "A value";
	      var_dump($obj["two"]);
	      $obj[] = 'Append 1';
	      $obj[] = 'Append 2';
	      $obj[] = 'Append 3';
	      print_r($obj);
	      ?>

	      The above example will output something similar to:

	      bool(true)
	      int(2)
	      bool(false)
	      string(7) "A value"
	      obj Object
	      (
		  [container:obj:private] => Array
		      (
			  [one] => 1
			  [three] => 3
			  [two] => A value
			  [0] => Append 1
			  [1] => Append 2
			  [2] => Append 3
		      )

	      )

PHP Documentation Group 													    ARRAYACCESS(3)

SPLOBJECTSTORAGE(3)							 1						       SPLOBJECTSTORAGE(3)

The SplObjectStorage class

INTRODUCTION

	The  SplObjectStorage  class  provides	a map from objects to data or, by ignoring data, an object set. This dual purpose can be useful in
       many cases involving the need to uniquely identify objects.

CLASS SYNOPSIS

       SplObjectStorage

       SplObjectStorageCountableIteratorSerializableArrayAccess

       Methods

       o public void SplObjectStorage::addAll (SplObjectStorage  $storage)

       o public void SplObjectStorage::attach NULL (object  $object, [mixed  $data])

       o public bool SplObjectStorage::contains (object  $object)

       o public int SplObjectStorage::count (void  )

       o public object SplObjectStorage::current (void	)

       o public void SplObjectStorage::detach (object  $object)

       o public string SplObjectStorage::getHash (object  $object)

       o public mixed SplObjectStorage::getInfo (void  )

       o public int SplObjectStorage::key (void  )

       o public void SplObjectStorage::next (void  )

       o public bool SplObjectStorage::offsetExists (object  $object)

       o public mixed SplObjectStorage::offsetGet (object  $object)

       o public void SplObjectStorage::offsetSet NULL (object  $object, [mixed	$data])

       o public void SplObjectStorage::offsetUnset (object  $object)

       o public void SplObjectStorage::removeAll (SplObjectStorage  $storage)

       o public void SplObjectStorage::removeAllExcept (SplObjectStorage  $storage)

       o public void SplObjectStorage::rewind (void  )

       o public string SplObjectStorage::serialize (void  )

       o public void SplObjectStorage::setInfo (mixed  $data)

       o public void SplObjectStorage::unserialize (string  $serialized)

       o public bool SplObjectStorage::valid (void  )

EXAMPLES

       Example #1

	      SplObjectStorage as a set

	      <?php
	      // As an object set
	      $s = new SplObjectStorage();

	      $o1 = new StdClass;
	      $o2 = new StdClass;
	      $o3 = new StdClass;

	      $s->attach($o1);
	      $s->attach($o2);

	      var_dump($s->contains($o1));
	      var_dump($s->contains($o2));
	      var_dump($s->contains($o3));

	      $s->detach($o2);

	      var_dump($s->contains($o1));
	      var_dump($s->contains($o2));
	      var_dump($s->contains($o3));
	      ?>

	      The above example will output:

	      bool(true)
	      bool(true)
	      bool(false)
	      bool(true)
	      bool(false)
	      bool(false)

       Example #2

	      SplObjectStorage as a map

	      <?php
	      // As a map from objects to data
	      $s = new SplObjectStorage();

	      $o1 = new StdClass;
	      $o2 = new StdClass;
	      $o3 = new StdClass;

	      $s[$o1] = "data for object 1";
	      $s[$o2] = array(1,2,3);

	      if (isset($s[$o2])) {
		  var_dump($s[$o2]);
	      }
	      ?>

	      The above example will output:

	      array(3) {
		[0]=>
		int(1)
		[1]=>
		int(2)
		[2]=>
		int(3)
	      }

PHP Documentation Group 												       SPLOBJECTSTORAGE(3)