Manuel PHP
Précédent | Chapitre 19. Les classes et les objets (PHP 5) | Suivant

# Parcours d'objets

PHP 5 fournit une façon de définir les objets de manière à ce qu'on puisse parcourir une liste de membres avec une structure foreach. Par défaut, toutes les propriétés visibles seront utilisées pour le parcours.

Exemple 19-21. Parcours d'objet simple
`<?php class MyClass { public $var1 = 'valeur 1'; public $var2 = 'valeur 2'; public $var3 = 'valeur 3'; protected $protected = 'variable protégée'; private $private = 'variable privée'; function iterateVisible() { echo "MyClass::iterateVisible:\n"; foreach($this as $key => $value) { print "$key => $value\n"; } } } $class = new MyClass(); foreach($class as $key => $value) { print "$key => $value\n"; } echo "\n"; $class->iterateVisible();`
L'exemple ci-dessus va afficher :
`var1 => valeur 1 var2 => valeur 2 var3 => valeur 3 MyClass::iterateVisible: var1 => valeur 1 var2 => valeur 2 var3 => valeur 3 protected => variable protégée private => variable privée`

Comme nous le montre l'affichage, l'itération foreach affiche toutes les variables visibles disponibles. Pour aller plus loin, vous pouvez implémenter l'interface interne de PHP 5 nommée Iterator. Ceci permet de déterminer comment l'objet doit être parcouru.

Exemple 19-22. Itération d'un objet implémentant un itérateur
`<?php class MyIterator implements Iterator { private $var = array(); public function __construct($array) { if (is_array($array) ) { $this->var = $array; } } public function rewind() { echo "rembobinage\n"; reset($this->var); } public function current() { $var = current($this->var); echo "actuel : $var\n"; return $var; } public function key() { $var = key($this->var); echo "clé : $var\n"; return $var; } public function next() { $var = next($this->var); echo "suivant : $var\n"; return $var; } public function valid() { $var = $this->current() !== false; echo "valide : {$var}\n"; return $var; } } $values = array(1,2,3); $it = new MyIterator($values); foreach ($it as $a => $b) { print "$a: $b\n"; }`
L'exemple ci-dessus va afficher :
`rembobinage actuel : 1 valide : 1 actuel : 1 clé : 0 0: 1 suivant : 2 actuel : 2 valide : 1 actuel : 2 clé : 1 1: 2 suivant : 3 actuel : 3 valide : 1 actuel : 3 clé : 2 2: 3 suivant : actuel : valide :`

Vous pouvez également définir votre classe de façon à ce qu'elle n'ait pas besoin de définir toutes les fonctions Iterator en implémentant simplement l'interface PHP 5 IteratorAggregate.

Exemple 19-23. Itération d'un objet implémentant IteratorAggregate
`<?php class MyCollection implements IteratorAggregate { private $items = array(); private $count = 0; // Définition requise de l'interface IteratorAggregate public function getIterator() { return new MyIterator($this->items); } public function add($value) { $this->items[$this->count++] = $value; } } $coll = new MyCollection(); $coll->add('valeur 1'); $coll->add('valeur 2'); $coll->add('valeur 3'); foreach ($coll as $key => $val) { echo "clé/valeur : [$key -> $val]\n\n"; } ?>`
L'exemple ci-dessus va afficher :
`rembobinage actuel : valeur 1 valide : 1 actuel : valeur 1 clé : 0 clé/valeur : [0 -> valeur 1] suivant : valeur 2 actuel : valeur 2 valide : 1 actuel : valeur 2 clé : 1 clé/valeur : [1 -> valeur 2] suivant : valeur 3 actuel : valeur 3 valide : 1 actuel : valeur 3 clé : 2 clé/valeur : [2 -> valeur 3] suivant : actuel : valide :`

> Note : Pour plus d'exemples sur le parcours d'objets, lisez la section sur l'extension SPL.

Précédent | Sommaire | Suivant
Surcharge | Niveau supérieur | Masques