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.
Itérables
Un iterable est un pseudo-type introduit en PHP 7.1. Il accepte n'importe quel tableau ou objet implémentant l'interface Traversable. Ces deux types d'itérables peuvent utiliser foreach et peuvent être appelés avec yield from depuis un générateur.
Utilisation des Itérables
Les Itérables peuvent être utilisés comme type d'argument pour indiquer qu'une fonction a besoin d'un ensemble de valeurs, mais se moque de la structure de l'ensemble puisqu'il va être utilisé avec foreach. Si une valeur passée en argument n'est pas un tableau ou une instance de Traversable, une exception TypeError sera lancée.
Exemple #1 Exemple de type d'argument itérable
<?php
function foo(iterable $iterable) {
foreach ($iterable as $value) {
// ...
}
}
?>
Les paramètres déclarés comme itérables peuvent utiliser null ou un tableau
comme valeur par défaut.
Exemple #2 Exemple de valeur par défaut d'un argument itérable
<?php
function foo(iterable $iterable = []) {
// ...
}
?>
Les itérables peuvent aussi être utilisés comme déclaration du type de retour pour indiquer qu'une fonction renverra une valeur itérable. Si la valeur renvoyée n'est pas un tableau ou une instance de Traversable, une exception TypeError sera lancée.
Exemple #3 Exemple de type de retour itérable.
<?php
function bar(): iterable {
return [1, 2, 3];
}
?>
Les fonctions déclarant un type de retour itérable peuvent aussi être des générateurs.
Exemple #4 Exemple de type de retour itérable d'un générateur
<?php
function gen(): iterable {
yield 1;
yield 2;
yield 3;
}
?>
add a note
User Contributed Notes 1 note
j_jaberi at yahoo dot com ¶
4 years ago
