La classe RecursiveArrayIterator

(PHP 5 >= 5.1.0, PHP 7, PHP 8)


Cet itérateur permet la suppression et la modification de valeurs et clés durant l'itération sur des tableaux et des objets, de la même façon que ArrayIterator. De plus, il est possible d'itérer sur l'élément courant.

Synopsis de la classe

class RecursiveArrayIterator extends ArrayIterator implements RecursiveIterator {
/* Constants héritées */
const int STD_PROP_LIST = 1;
const int ARRAY_AS_PROPS = 2;
/* Constantes */
const int CHILD_ARRAYS_ONLY = 4;
/* Méthodes */
public hasChildren(): bool
/* Méthodes héritées */
public ArrayIterator::append(mixed $value): void
public ArrayIterator::asort(int $flags = SORT_REGULAR): bool
public ArrayIterator::count(): int
public ArrayIterator::key(): string|int|null
public ArrayIterator::ksort(int $flags = SORT_REGULAR): bool
public ArrayIterator::natsort(): bool
public ArrayIterator::next(): void
public ArrayIterator::offsetSet(mixed $key, mixed $value): void
public ArrayIterator::rewind(): void
public ArrayIterator::seek(int $offset): void
public ArrayIterator::serialize(): string
public ArrayIterator::setFlags(int $flags): void
public ArrayIterator::uasort(callable $callback): bool
public ArrayIterator::uksort(callable $callback): bool
public ArrayIterator::unserialize(string $data): void
public ArrayIterator::valid(): bool

Constantes pré-définies

Contantes RecursiveArrayIterator


Traitez uniquement les tableaux (et non les objets) comme ayant des enfants pour l'itération récursive.


add a note add a note

User Contributed Notes 3 notes

c dot 1 at smithies dot org
10 years ago
If you are iterating over a multi-dimensional array of objects, you may be tempted to use a RecursiveArrayIterator within a RecursiveIteratorIterator. You are likely to get baffling results if you do. That is because RecursiveArrayIterator treats all objects as having children, and tries to recurse into them. But if you are interested in having your RecursiveIteratorIterator return the objects in your multi-dimensional array, then you don't want the default setting LEAVES_ONLY, because no object can be a leaf (= has no children).

The solution is to extend the RecursiveArrayIterator class and override the hasChildren method appropriately. Something like the following might be suitable:

class RecursiveArrayOnlyIterator extends RecursiveArrayIterator {
  public function
hasChildren() {
Of course, this simple example will not recurse into ArrayObjects either!
mccarthy dot richard at gmail dot com
11 years ago
Using the RecursiveArrayIterator to traverse an unknown amount of sub arrays within the outer array. Note: This functionality is already provided by using the RecursiveIteratorIterator but is useful in understanding how to use the iterator when using for the first time as all the terminology does get rather confusing at first sight of SPL!

= array(
0 => 'a',
1 => array('subA','subB',array(0 => 'subsubA', 1 => 'subsubB', 2 => array(0 => 'deepA', 1 => 'deepB'))),
2 => 'b',
3 => array('subA','subB','subC'),
4 => 'c'

$iterator = new RecursiveArrayIterator($myArray);
iterator_apply($iterator, 'traverseStructure', array($iterator));

traverseStructure($iterator) {
    while (
$iterator -> valid() ) {

        if (
$iterator -> hasChildren() ) {
traverseStructure($iterator -> getChildren());
        else {
$iterator -> key() . ' : ' . $iterator -> current() .PHP_EOL;   

$iterator -> next();

The output from which is:
0 : a
0 : subA
1 : subB
0 : subsubA
1 : subsubB
0 : deepA
1 : deepB
2 : b
0 : subA
1 : subB
2 : subC
4 : c
lemoinem dot remove at me dot mlemoine dot name
8 years ago
The RecursiveArrayOnlyIterator behaviour c dot 1 at smithies dot org presented can also be achieved using the (undocumented) flag RecursiveArrayIterator::CHILD_ARRAYS_ONLY ( and
To Top