iterator_apply

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

iterator_apply — 对迭代器中的每个元素调用函数

说明

iterator_apply(Traversable $iterator, callable $callback, ?array $args = null): int

对迭代器中的每个元素调用函数。

参数

iterator

要迭代的迭代器对象。

callback

要对每个元素调用的回调函数。此函数只接收给定的 args，因此默认情况下它是空元的。例如，如果 count($args) === 3，则回调函数是三元的。

注意: 该函数必须返回 true 以便继续迭代 iterator。

args

一个 array 类型的参数；args 的每个元素都作为单独的参数传递给回调 callback。

返回值

返回迭代次数。

示例

示例 #1 iterator_apply() 示例

<?php
function print_caps(Iterator $iterator) {
 echo strtoupper($iterator->current()) . "\n";
 return TRUE;
}

$it = new ArrayIterator(array("Apples", "Bananas", "Cherries"));
iterator_apply($it, "print_caps", array($it));
?>

上面的示例将输出

APPLES
BANANAS
CHERRIES

参见

array_walk() - 将用户提供的函数应用于数组的每个成员

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加备注

用户贡献的备注 3 个备注

上

下

tezcatl at fedoraproject dot org ¶

5 年前

函数所需的每个参数都必须位于传递给 iterator_apply 的第三个参数中的数组中。您也可以使用引用。示例

<?php

function translate_to(string $target_language, Iterator $words, array $dictionaries) {
 
 $language = ucfirst($target_language);
 $dictionary = $dictionaries[$target_language] ?? 'not found';
 
 if ($dictionary === 'not found') {
 echo "Not found dictionary for {$language}\n";
 return;
 }
 
 echo "English words translated to {$language}\n";
 
 $not_found = [];
 
 iterator_apply($words, function($words, $dictionary, &$not_found){
 
 $english_word = $words->current();
 
 $translated_word = $dictionary[$english_word] ?? '';
 
 if ($translated_word !== '') {
 echo "{$english_word} translates to {$translated_word}\n";
 } else {
 $not_found[] = $english_word;
 }

 return true;
 
 }, array($words, $dictionary, &$not_found));
 
 echo "\nNot found words:\n" . implode("\n", $not_found) . "\n";
}

$dictionaries = [
 'nahuatl' => [
 'one' => 'Ze',
 'two' => 'Ome',
 'three' => 'Yei',
 'four' => 'Nahui',
 ],
];

$iterator = new \ArrayIterator(array('one', 'two', 'three', 'four', 'gasoil'));

translate_to('nahuatl', $iterator, $dictionaries);
?>

英语单词翻译成纳瓦特尔语
one 翻译成 Ze
two 翻译成 Ome
three 翻译成 Yei
four 翻译成 Nahui

未找到的单词
gasoil

上

下

tezcatl at fedoraproject dot org ¶

5 年前

请注意，要迭代您正在使用的特定迭代器，需要使用正确的方法，因为方法的实现可能会改变其行为。

例如，与 ArrayIterator 不同，您不能在 SplDoubleLinkedList 上迭代 current()，除非在每次迭代时使用 next()（然后，只有当您在可调用对象结束时返回 true 时才会迭代。使用 LinkedList 时，使用 while($it->valid()) { $it->current(); $it->next(); } 则容易得多。

让我们看看

<?php

$ll = new \SplDoublyLinkedList();

$ll->push('ze');
$ll->push('ome');
$ll->push('yei');
$ll->push('nahui');

$ll->rewind();

$iterations_done = iterator_apply($ll, function(Iterator $it) {

 echo implode("\t=>", [
 $it->key(),
 $it->current(),
 ucfirst($it->current())
 ]),"\n";
 
 return true;

}, array($ll));

echo "Did iterate {$iterations_done} times \n";

$ll->rewind();

$iterations_done = iterator_apply($ll, function(Iterator $it) {

 echo implode("\t=>", [
 $it->key(),
 $it->current(),
 ucfirst($it->current())
 ]),"\n";
 
 $it->next();
 
 return true;

}, array($ll));

echo "Did iterate {$iterations_done} times \n";

$ll->setIteratorMode(SplDoublyLinkedList::IT_MODE_FIFO | SplDoublyLinkedList::IT_MODE_DELETE);

var_dump($ll->count());

foreach($ll as $key => $val) {
 echo "{$key}\t",ucfirst($val),"\n";
}

var_dump($ll->count());
?>

输出

0 =>ze =>Ze
0 =>ze =>Ze
0 =>ze =>Ze
0 =>ze =>Ze
Did iterate 4 times
0 =>ze =>Ze
1 =>ome =>Ome
2 =>yei =>Yei
3 =>nahui =>Nahui
Did iterate 4 times
int(4)
0 Ze
0 Ome
0 Yei
0 Nahui
int(0)

上

下

-1

ycgambo at outlook dot com ¶

6 年前

$args 是一个数组，其每个元素都作为单独的参数传递给回调函数。

所以这是获取参数的正确方法

<?php
$ai = new ArrayIterator(range(0, 2));

iterator_apply($ai, function() {
 var_dump(func_get_args()); // 使用此函数
 return true;
}, array(1, 2));
?>

输出

array(2) {
  [0] =>
int(1)
  [1] =>
int(2)
}
array(2) {
  [0] =>
int(1)
  [1] =>
int(2)
}
array(2) {
  [0] =>
int(1)
  [1] =>
int(2)
}

--------------------------------------------------
或者列出每个参数

<?php
$ai = new ArrayIterator(range(0, 2));

iterator_apply($ai, function($arg1, $arg2, $arg3) {
 var_dump([$arg1, $arg2, $arg3]);
 return true;
}, array(1, 2));
?>

相同的输出。