Конструктор класса RecursiveIteratorIterator


(PHP 5 >= 5.1.3)

RecursiveIteratorIterator::__constructКонструктор класса RecursiveIteratorIterator

Описание

public RecursiveIteratorIterator::__construct ( Traversable $iterator [, int $mode = RecursiveIteratorIterator::LEAVES_ONLY [, int $flags = 0 ]] )

Создает новый объект класса RecursiveIteratorIterator на основе объекта RecursiveIterator.

Список параметров

iterator

Объект-итератор, на основе которого требуется построить данный экземпляр. Это может быть объект класса RecursiveIterator или класса IteratorAggregate.

mode

Необязательный параметр. Задание режима работы конструктора. Возможные значения:

  • RecursiveIteratorIterator::LEAVES_ONLY - По умолчанию. Навигация будет осуществляться только по листам дерева элементов.
  • RecursiveIteratorIterator::SELF_FIRST - Навигация будет осуществляться по всему дереву элементов, причем первыми будут идти родительские элементы.
  • RecursiveIteratorIterator::CHILD_FIRST - Навигация будет осуществляться по всему дереву элементов, причем первыми будут идти дочерние элементы.

flags

Необязательный настроечный флаг. Возможное значение RecursiveIteratorIterator::CATCH_GET_CHILD дает предписание объекту не принимать во внимание исключения, которые вызывает метод RecursiveIteratorIterator::getChildren().

Возвращаемые значения

Эта функция не возвращает значения после выполнения.

Примеры

Пример #1 Навигация по дереву элементов с помощью RecursiveIteratorIterator

<?php
$array 
= array(
    array(
        array(
            array(
                
'leaf-0-0-0-0',
                
'leaf-0-0-0-1'
            
),
            
'leaf-0-0-0'
        
),
        array(
            array(
                
'leaf-0-1-0-0',
                
'leaf-0-1-0-1'
            
),
            
'leaf-0-1-0'
        
),
        
'leaf-0-0'
    
)
);

$iterator = new RecursiveIteratorIterator(
    new 
RecursiveArrayIterator($array),
    
$mode
);
foreach (
$iterator as $key => $leaf) {
    echo 
"$key => $leaf"PHP_EOL;
}
?>

Вывод примера в режиме $mode = RecursiveIteratorIterator::LEAVES_ONLY

 0 => leaf-0-0-0-0 1 => leaf-0-0-0-1 0 => leaf-0-0-0 0 => leaf-0-1-0-0 1 => leaf-0-1-0-1 0 => leaf-0-1-0 0 => leaf-0-0 

Вывод примера в режиме $mode = RecursiveIteratorIterator::SELF_FIRST

 0 => Array 0 => Array 0 => Array 0 => leaf-0-0-0-0 1 => leaf-0-0-0-1 1 => leaf-0-0-0 1 => Array 0 => Array 0 => leaf-0-1-0-0 1 => leaf-0-1-0-1 1 => leaf-0-1-0 2 => leaf-0-0 

Вывод примера в режиме $mode = RecursiveIteratorIterator::CHILD_FIRST

 0 => leaf-0-0-0-0 1 => leaf-0-0-0-1 0 => Array 1 => leaf-0-0-0 0 => Array 0 => leaf-0-1-0-0 1 => leaf-0-1-0-1 0 => Array 1 => leaf-0-1-0 1 => Array 2 => leaf-0-0 0 => Array