PHP 7.0.6 Released

    iterator_to_array

    (PHP 5 >= 5.1.0, PHP 7)

    iterator_to_array — Copy the iterator into an array

    Description

    array iterator_to_array ( Traversable $iterator [, bool $use_keys = true ] )

    Copy the elements of an iterator into an array.

    Parameters

    iterator

    The iterator being copied.

    use_keys

    Whether to use the iterator element keys as index.

    In PHP 5.5 and later, if a key is an array or object, a warning will be generated. NULL keys will be converted to an empty string, double keys will be truncated to their integer counterpart, resource keys will generate a warning and be converted to their resource ID, and boolean keys will be converted to integers.

    Return Values

    An array containing the elements of the iterator.

    Changelog

    Version Description
    5.5.0 iterator_to_array() gained support for key types other than integer and string when the use_keys parameter is enabled.
    5.2.1 The use_keys parameter was added.

    Examples

    Example #1 iterator_to_array() example

    <?php
    $iterator     = new ArrayIterator(array('recipe'=>'pancakes', 'egg', 'milk', 'flour'));
    var_dump(iterator_to_array($iterator, true));
    var_dump(iterator_to_array($iterator, false));
    ?>

    The above example will output:

    array(4) {
  ["recipe"]=>
  string(8) "pancakes"
  [0]=>
  string(3) "egg"
  [1]=>
  string(4) "milk"
  [2]=>
  string(5) "flour"
}
array(4) {
  [0]=>
  string(8) "pancakes"
  [1]=>
  string(3) "egg"
  [2]=>
  string(4) "milk"
  [3]=>
  string(5) "flour"
}

    User Contributed Notes

    jerome at yazo dot net
    7 years ago
    Using the boolean param :

    <?php

    $first     = new ArrayIterator( array('k1' => 'a' , 'k2' => 'b',  'k3' => 'c',  'k4' => 'd') );
    $second = new ArrayIterator( array( 'k1' => 'X', 'k2' => 'Y', 'Z' ) );

    $combinedIterator= new AppendIterator();
    $combinedIterator->append( $first );
    $combinedIterator->append( $second );

    var_dump( iterator_to_array($combinedIterator, false) );

    ?>

    will output :

    array(7) (
      [0]=>
      string(1) "a"
      [1]=>
      string(1) "b"
      [2]=>
      string(1) "c"
      [3]=>
      string(1) "d"
      [4]=>
      string(1) "X"
      [5]=>
      string(1) "Y"
      [6]=>
      string(1) "Z"
    )

    <?php

    var_dump    ( iterator_to_array($combinedIterator, true) );

    ?>

    will output (since keys would merge) :

    array(5) (
      ["k1"]=>
      string(1) "X"
      ["k2"]=>
      string(1) "Y"
      ["k3"]=>
      string(1) "c"
      ["k4"]=>
      string(1) "d"
      [0]=>
      string(1) "Z"
    )
    chad 0x40 herballure 0x2e com
    8 years ago
    The use_keys parameter was added in one of the 5.2.x releases; it defaults to TRUE. This matches the behavior in PHP 5.1.6, which lacks this parameter.
    Harry Willis
    10 months ago
    When using iterator_to_array() on an SplObjectStorage object, it's advisable to set $use_keys to false.

    The resulting array is identical, since the iterator keys produced by SplObjectStorage::key() are always integers from 0 to (COUNT-1). Passing $use_keys=false cuts out the unnecessary calls to SplObjectStorage::key(), giving a slight performance advantage.
    joksnet at gmail dot com
    1 year ago
    To generate an deep array from nested iterators:

    <?php
    function iterator_to_array_deep(\Traversable $iterator, $use_keys = true) {
            $array = array();
        foreach (    $iterator as $key => $value) {
            if (    $value instanceof \Iterator) {
                    $value = iterator_to_array_deep($value, $use_keys);
            }
            if (    $use_keys) {
                    $array[$key] = $value;
            } else {
                    $array[] = $value;
            }
        }
        return     $array;
    }
    ?>

    I use it to test an iterator: https://gist.github.com/jm42/cb328106f393eeb28751
    To Top