iteratoraggregate(3) [php man page]

ITERATORAGGREGATE(3)							 1						      ITERATORAGGREGATE(3)

The IteratorAggregate interface

INTRODUCTION

	Interface to create an external Iterator.

INTERFACE SYNOPSIS

       IteratorAggregate

       IteratorAggregateextends
       Traversable

       Methods

       o abstractpublic Traversable IteratorAggregate::getIterator (void  )

       Example #1

	      Basic usage

	      <?php
	      class myData implements IteratorAggregate {
		  public $property1 = "Public property one";
		  public $property2 = "Public property two";
		  public $property3 = "Public property three";

		  public function __construct() {
		      $this->property4 = "last property";
		  }

		  public function getIterator() {
		      return new ArrayIterator($this);
		  }
	      }

	      $obj = new myData;

	      foreach($obj as $key => $value) {
		  var_dump($key, $value);
		  echo "
";
	      }
	      ?>

	      The above example will output something similar to:

	      string(9) "property1"
	      string(19) "Public property one"

	      string(9) "property2"
	      string(19) "Public property two"

	      string(9) "property3"
	      string(21) "Public property three"

	      string(9) "property4"
	      string(13) "last property"

PHP Documentation Group 												      ITERATORAGGREGATE(3)

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)