生成器总览

(PHP 5 >= 5.5.0)

生成器提供了一种更容易的方法来实现简单的对象迭代，相比较定义类实现 Iterator 接口的方式，性能开销和复杂性大大降低。

生成器允许你在 foreach 代码块中写代码来迭代一组数据而不需要在内存中创建一个数组, 那会使你的内存达到上限，或者会占据可观的处理时间。相反，你可以写一个生成器函数，就像一个普通的自定义函数一样, 和普通函数只返回一次不同的是, 生成器可以根据需要 yield 多次，以便生成需要迭代的值。

一个简单的例子就是使用生成器来重新实现 range() 函数。标准的 range() 函数需要在内存中生成一个数组包含每一个在它范围内的值，然后返回该数组, 结果就是会产生多个很大的数组。比如，调用 range(0, 1000000) 将导致内存占用超过 100 MB。

做为一种替代方法, 我们可以实现一个 xrange() 生成器, 只需要足够的内存来创建 Iterator 对象并在内部跟踪生成器的当前状态，这样只需要不到1K字节的内存。

Example #1 将 range() 实现为生成器

  <?php
  function  xrange ( $start ,  $limit ,  $step  =  1 ) {
    if ( $start  <  $limit ) {
        if ( $step  <=  0 ) {
            throw new  LogicException ( 'Step must be +ve' );
        }
 
        for ( $i  =  $start ;  $i  <=  $limit ;  $i  +=  $step ) {
             yield $i ;
        }
    } else {
        if ( $step  >=  0 ) {
            throw new  LogicException ( 'Step must be -ve' );
        }
 
        for ( $i  =  $start ;  $i  >=  $limit ;  $i  +=  $step ) {
             yield $i ;
        }
    }
}
 
  /* 
 * 注意下面range()和xrange()输出的结果是一样的。
 */
 
  echo  'Single digit odd numbers from range():  ' ;
foreach ( range ( 1 ,  9 ,  2 ) as  $number ) {
    echo  " $number  " ;
}
echo  "\n" ;
 
echo  'Single digit odd numbers from xrange(): ' ;
foreach ( xrange ( 1 ,  9 ,  2 ) as  $number ) {
    echo  " $number  " ;
}
  ?>

以上例程会输出：

Single digit odd numbers from range():  1 3 5 7 9 
Single digit odd numbers from xrange(): 1 3 5 7 9

Generator objects

When a generator function is called for the first time, an object of the internal Generator class is returned. This object implements the Iterator interface in much the same way as a forward-only iterator object would, and provides methods that can be called to manipulate the state of the generator, including sending values to and returning values from it.

PHP中文手册

版权信息

PHP 手册

入门指引

安装与配置

语言参考

安全

特点

函数参考

PHP 核心：骇客指南

FAQ

附录

生成器总览

Generator objects