iterator_to_array

(PHP 5 >= 5.1.0, PHP 7)

iterator_to_array Copie un itérateur dans un tableau

Description

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

Copie les éléments d'un itérateur dans un tableau.

Liste de paramètres

iterator

L'itérateur à copier.

use_keys

S'il faut utiliser les éléments de l'itérateur comme clé.

En PHP 5.5 et suivants, si une clé est un array ou un object, une alerte sera générée. Les clés NULL seront converties en une chaîne vide, les clés de type float seront tronquées en leurs parties integer, les clés de type resource génèreront une alerte et seront converties en identifiant de la ressource, et les clés de type boolean seront converties en entiers.

Note:

Si ce paramètre n'est pas défini ou défini sur TRUE, les clés dupliquées seront écrasées. La dernière valeur avec une clé donnée sera dans le array retourné. Réglez ce paramateur sur FALSE pour obtenir toutes les valeurs en tout cas.

Valeurs de retour

Un tableau contenant les éléments de l'itérateur iterator.

Historique

Version Description
5.5.0 iterator_to_array() supporte désormais les clés de types autres que integer et string lorsque le paramètre use_keys est activé.
5.2.1 Ajout du paramètre use_keys.

Exemples

Exemple #1 Exemple avec iterator_to_array()

<?php
$iterator 
= new ArrayIterator(array('recipe'=>'crêpes''oeufs''lait''farine'));
var_dump(iterator_to_array($iteratortrue));
var_dump(iterator_to_array($iteratorfalse));
?>

L'exemple ci-dessus va afficher :

array(4) {
  ["recipe"]=>
  string(7) "crêpes"
  [0]=>
  string(5) "oeufs"
  [1]=>
  string(4) "lait"
  [2]=>
  string(6) "farine"
}
array(4) {
  [0]=>
  string(7) "crêpes"
  [1]=>
  string(5) "oeufs"
  [2]=>
  string(4) "lait"
  [3]=>
  string(6) "farine"
}