iterator_to_array
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.
Note: If this parameter is not set or set toTRUE, duplicate keys will be overwritten. The last value with a given key will be in the returned array. Set this paramater toFALSEto get all the values in any case.
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"
}
← iterator_count
spl_autoload_call →
© 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://secure.php.net/manual/en/function.iterator-to-array.php
