Класс ParentIterator

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

Введение

Это расширенный класс от FilterIterator, позволяющий осуществить рекурсивную итерацию, используя класс RecursiveIteratorIterator, который показывает только те элементы, которые имеют потомков.

Обзор классов

class ParentIterator extends RecursiveFilterIterator {

/* Методы */

public __construct(RecursiveIterator $iterator)

public accept(): bool

public getChildren(): ParentIterator

public hasChildren(): bool

public next(): void

public rewind(): void

/* Наследуемые методы */

public RecursiveFilterIterator::getChildren(): ?RecursiveFilterIterator

public RecursiveFilterIterator::hasChildren(): bool

public FilterIterator::accept(): bool

public FilterIterator::current(): mixed

public FilterIterator::key(): mixed

public FilterIterator::next(): void

public FilterIterator::rewind(): void

public FilterIterator::valid(): bool

public IteratorIterator::current(): mixed

public IteratorIterator::getInnerIterator(): ?Iterator

public IteratorIterator::key(): mixed

public IteratorIterator::next(): void

public IteratorIterator::rewind(): void

public IteratorIterator::valid(): bool

}

Содержание

ParentIterator::accept — Определение доступности
ParentIterator::__construct — Конструктор класса ParentIterator
ParentIterator::getChildren — Возвращает дочерние объекты итератора, хранящегося внутри ParentIterator
ParentIterator::hasChildren — Проверяет, имеет ли внутренний объект-итератор дочерние объекты
ParentIterator::next — Перемещает указатель на одну позицию вперёд
ParentIterator::rewind — Переводит итератор на начало

＋add a note

User Contributed Notes 2 notes

down

Anonymous ¶

11 years ago

ParentIterator is just a RecursiveFilterIterator whos accept() method calls the RecursiveFilterIterator->hasChildren() method to filter itself.

Basically, it filters out leaf nodes. For example

This would yield all files and directories
<?php
$rdi = new RecursiveDirectoryIterator(__DIR__);
$iter = new RecursiveIteratorIterator($rdi, RecursiveIteratorIterator::CHILD_FIRST);
?>

wrapping that in a ParentIterator would filter it down to just directories
<?php
$rdi = new RecursiveDirectoryIterator(__DIR__);
$iter = new RecursiveIteratorIterator($rdi, RecursiveIteratorIterator::CHILD_FIRST);
$dirsOnly = new ParentIterator($iter);
?>

down

dn dot permyakov at gmail dot com ¶

4 years ago

Easy example for understanding:
<?php

$iterator = new ParentIterator(
    new RecursiveArrayIterator(
        array(array(1, 2, 3), 'A', 'B', 'C')
    )
);

foreach ($iterator as $recursive) {
    foreach ($recursive as $value) {
        echo $value . PHP_EOL;
    }
}
?>

1
2
3

＋add a note