La classe CallbackFilterIterator

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

Introduction

Synopsis de la classe

class CallbackFilterIterator extends FilterIterator {
/* Méthodes */
public __construct(Iterator $iterator, callable $callback)
public accept(): bool
/* Méthodes héritées */
public FilterIterator::accept(): bool
public FilterIterator::current(): mixed
public FilterIterator::getInnerIterator(): Iterator
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
}

Exemples

La fonction de rappel doit accepter jusqu'à trois arguments : l'élément courant, la clé courante et l'itérateur courant, respectivement.

Exemple #1 Arguments disponibles pour la fonction de rappel

<?php

/**
 * Fonction de rappel pour CallbackFilterIterator
 *
 * @param $current   Valeur de l'élément courant
 * @param $key       Clé de l'élément courant
 * @param $iterator  Itérateur à filtrer
 * @return boolean   TRUE pour accepter l'élément courant, FALSE sinon
 */
function my_callback($current, $key, $iterator) {
    // Votre filtre ici
}

?>

N'importe quel callable peut être utilisé ; comme une chaîne de caractères contenant un nom de fonction, un tableau pour une méthode, ou une fonction anonyme.

Exemple #2 Exemples simples de fonction de rappel

<?php

$dir = new FilesystemIterator(__DIR__);

// Filtre les gros fichiers ( > 100MB)
function is_large_file($current) {
    return $current->isFile() && $current->getSize() > 104857600;
}
$large_files = new CallbackFilterIterator($dir, 'is_large_file');

// Filtre les dossiers
$files = new CallbackFilterIterator($dir, function ($current, $key, $iterator) {
    return $current->isDir() && ! $iterator->isDot();
});

?>

Sommaire