Ds\Map::get

(PECL ds >= 1.0.0)

Ds\Map::get — Renvoie la valeur pour une clé donnée

Description

public function Ds\Map::get(mixed $key, mixed $default = ?): mixed

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 prises en charge. 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:
Il est également possible d'utiliser la syntaxe de tableau pour accéder aux valeurs par clé, par exemple $map["clé"].

Attention

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.

Liste de paramètres

key: La clé à rechercher.
default: La valeur par défaut optionnelle, renvoyée si la clé n'a pas pu être trouvée.

Valeurs de retour

La valeur mappée à la key donnée, ou la default si fournie et que la clé n'a pas pu être trouvée dans la carte.

Erreurs / Exceptions

OutOfBoundsException si la clé n'a pas pu être trouvée et qu'aucune valeur par défaut n'a été fournie.

Exemples

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 (valeur par défaut utilisée)
?>

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)

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.