(PECL ds >= 1.0.0)
Ds\Map::get — Renvoie la valeur pour une clé donnée
Renvoie la valeur pour une clé donnée, ou une valeur par défaut optionnelle si la clé n'a pas pu être trouvée.
Note:
Les clés de type object sont supportées. Si un objet implémente Ds\Hashable, l'égalité sera déterminée par la fonction
equals
de l'objet. Si un objet n'implémente pas Ds\Hashable, les objets doivent être des références à la même instance pour être considérés comme égaux.
Note:
Vous pouvez également utiliser la syntaxe de tableau pour accéder aux valeurs par clé, par exemple
$map["clé"]
.
Attention à l'utilisation de la syntaxe de tableau. Les clés scalaires seront coercées en
entiers par le moteur. Par exemple, $map["1"]
tentera d'accéder à int(1)
,
tandis que $map->get("1")
recherchera correctement la clé de chaîne.
Voir tableau.
key
La clé à rechercher.
default
La valeur par défaut optionnelle, renvoyée si la clé n'a pas pu être trouvée.
La valeur mappée à la clé
donnée, ou la valeur par défaut
si fournie et que la clé n'a pas pu être trouvée dans la carte.
OutOfBoundsException si la clé n'a pas pu être trouvée et qu'aucune valeur par défaut n'a été fournie.
Exemple #1 Exemple de Ds\Map::get()
<?php
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
var_dump($map->get("a")); // 1
var_dump($map->get("d", 10)); // 10 (utiliser par défaut)
?>
Résultat de l'exemple ci-dessus est similaire à :
int(1) int(10)
Exemple #2 Exemple de Ds\Map::get()utilisant la syntaxe de tableau
<?php
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
var_dump($map["a"]); // 1
?>
Résultat de l'exemple ci-dessus est similaire à :
int(1)