array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'class.callbackfilteriterator.php', 1 => 'CallbackFilterIterator', 2 => 'CallbackFilterIterator クラス', ), 'up' => array ( 0 => 'spl.iterators.php', 1 => 'イテレータ', ), 'prev' => array ( 0 => 'cachingiterator.valid.php', 1 => 'CachingIterator::valid', ), 'next' => array ( 0 => 'callbackfilteriterator.accept.php', 1 => 'CallbackFilterIterator::accept', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/spl/callbackfilteriterator.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.callbackfilteriterator.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

CallbackFilterIterator クラス

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

はじめに

クラス概要

class CallbackFilterIterator extends FilterIterator {
/* メソッド */
public __construct(Iterator $iterator, callable $callback)
public accept(): 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
}

例

コールバックは、三つの引数を受け付けなければなりません。 それぞれ、現在のアイテム、現在のキー、そしてイテレータを表します。

例1 利用可能なコールバック引数

<?php

/**
* CallbackFilterIterator 用のコールバック
*
* @param $current 現在のアイテムの値
* @param $key 現在のアイテムのキー
* @param $iterator フィルタリングするイテレータ
* @return boolean 現在のアイテムを受け付ける場合は TRUE、それ以外の場合は FALSE
*/
function my_callback($current, $key, $iterator) {
// ここにフィルタリングのコードを書きます
}

?>

任意の 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();
});

?>

目次