PHP - Manual: Iterable 可迭代对象

2024-11-23

Object 对象 »

« Array 数组

Iterable 可迭代对象

Iterable是 PHP 7.1 中引入的一个伪类型。它接受任何 array 或实现了 Traversable 接口的对象。这些类型都能用 foreach 迭代，也可以和生成器里的 yield from 一起使用。

使用可迭代对象

可迭代对象可以用作参数类型，表示函数需要一组值，但是不会关心值集的形式，因为它将与 foreach 一起使用。如果一个值不是数组或 Traversable 的实例，则会抛出一个 TypeError。

示例 #1 Iterable 可迭代参数类型示例


<?php

function foo(iterable $iterable) {
    foreach ($iterable as $value) {
        // ...
    } 
}

?>

声明为可迭代的参数可能会使用 null 或者一个数组作为默认值。

示例 #2 可迭代参数默认值示例


<?php

function foo(iterable $iterable = []) {
    // ...
}

?>

可迭代对象还可以用作返回类型，表示函数将返回一个可迭代的值。如果返回值不是数组或 Traversable 的实例，则会抛出一个 TypeError。

示例 #3 可迭代返回类型示例


<?php

function bar(): iterable {
    return [1, 2, 3];
}

?>

将可迭代对象声明为返回类型的函数也可能是生成器。

示例 #4 可迭代生成器返回类型的示例


<?php

function gen(): iterable {
    yield 1;
    yield 2;
    yield 3;
}

?>

add a note

User Contributed Notes 1 note

down

-51

j_jaberi at yahoo dot com ¶

2 years ago


Just to note:
Though objects may (or may not) be Traversable, the can use in foreach because implicit conversion to array
<?php
class Foo {
    public $a = 1;
    public $b = "Helo";
};

$bar = new Foo;

foreach($bar as $elm) {
    echo $elm . ' ';
}

?> 
prints 1 Hello
Even
<?php
$bar = new stdClass
foreach($bar as $elm) {
    echo $elm . ' ';
}
?>
is correct.

add a note

官方地址：https://www.php.net/manual/en/language.types.iterable.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络 JAVA NoSQL 数据库面试 C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

略微加速

PHP官方手册 - 互联网笔记

Iterable 可迭代对象

使用可迭代对象

User Contributed Notes 1 note