Surcharge
<<<
Les Itération Masques
>>>

5.10 Les classes et les objets (PHP 5)
5 Référence du langage
 Manuel PHP

Introduction
Les notions de base
Auto-chargement de classes
Constructeurs et destructeurs
Visibilité
L'opérateur de résolution de portée (::)
Statique
Constantes
Abstraction d'objets
Interfaces
Surcharge
->Les Itération
Masques
Méthodes magiques
Mot clé "final"
Duplication d'objets
Comparaison d'objets
Réflexion
Typage optionnel des paramètres

5.10.12 Les Itération

PHP 5 fournit une façon pour les objets d'être définis, donc il est possible d'itérer à travers une liste d'éléments, avec, par exemple, une structure foreach . Par défaut, toutes les propriétés visibles seront utilisées pour cette itération.

Un objet simple itéré

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

Comme nous le montre l'affichage, l'itération foreach affiche toutes les variables visibles disponibles. Pour aller plus loin, vous pouvez implémenter un des itérateurs interface nommés Iterator à PHP 5. Cela permet à l'objet de décider quoi et quand l'objet doit être itéré.

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";
}

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

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";
}
?>
Note

Pour plus d'exemples sur les itérations, lisez la section sur l' extension SPL .

<< Les Itération >>
Surcharge Les classes et les objets (PHP 5) Masques