Класс CallbackFilterIterator

(PHP 5 >= 5.4.0, PHP 7)

Введение

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

CallbackFilterIterator extends FilterIterator implements OuterIterator {

/* Методы */

public __construct ( Iterator $iterator , callable $callback )

public accept ( ) : bool

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

public abstract FilterIterator::accept ( ) : bool

public FilterIterator::__construct ( Iterator $iterator )

public FilterIterator::current ( ) : mixed

public FilterIterator::getInnerIterator ( ) : Iterator

public FilterIterator::key ( ) : mixed

public FilterIterator::next ( ) : void

public FilterIterator::rewind ( ) : void

public FilterIterator::valid ( ) : bool

}

Примеры

Callback-функция может принимать до трех аргументов: текущий элемент, текущий ключ и итератор соответственно.

Пример #1 Доступные аргументы обратного вызова


<?php

/**
 * Callback-функция для CallbackFilterIterator
 *
 * @param $current   Значение текущего элемента
 * @param $key       Ключ текущего элемента
 * @param $iterator  Фильтруемый итератор
 * @return boolean   TRUE для принятия текущего элемента, иначе - FALSE
 */
function my_callback($current, $key, $iterator) {
    // Код фильтрации
}

?>

Любая callback-функция типа callable может быть использована. Например, строка, содержащая имя функции, массив для метода или анонимная функция.

Пример #2 Основные примеры обратного вызова


<?php

$dir = new FilesystemIterator(__DIR__);

// Фильтр больших файлов ( > 100MB)
function is_large_file($current) {
    return $current->isFile() && $current->getSize() > 104857600;
}
$large_files = new CallbackFilterIterator($dir, 'is_large_file');

// Фильтр каталогов
$files = new CallbackFilterIterator($dir, function ($current, $key, $iterator) {
    return $current->isDir() && ! $iterator->isDot();
});

?>

Содержание

CallbackFilterIterator::accept — Вызывает callback-функцию и передает ей в качестве аргументов текущее значение, текущий ключ и внутренний указатель
CallbackFilterIterator::__construct — Создает фильтрующий итератор на основе другого итератора