(PECL ds >= 1.0.0)
Ds\Map::get — Devuelve el valor para una clave dada
Devuelve el valor para una clave dada, o un valor por defecto opcional si la clave no ha podido ser encontrada.
Nota:
Las claves de tipo object son soportadas. Si un objeto implementa Ds\Hashable, la igualdad será determinada por la función
equalsdel objeto. Si un objeto no implementa Ds\Hashable, los objetos deben ser referencias a la misma instancia para ser considerados iguales.
Nota:
Asimismo, se puede utilizar la sintaxis de array para acceder a los valores por clave, por ejemplo
$map["clé"].
Atención al uso de la sintaxis de array. Las claves escalares serán coercionadas a
enteros por el motor. Por ejemplo, $map["1"] intentará acceder a int(1),
mientras que $map->get("1") buscará correctamente la clave de string.
Ver array.
keyLa clave a buscar.
defaultEl valor por defecto opcional, devuelto si la clave no ha podido ser encontrada.
El valor mapeado a la clave dada, o el valor por defecto
si se proporciona y la clave no ha podido ser encontrada en el mapa.
OutOfBoundsException si la clave no ha podido ser encontrada y ningún valor por defecto ha sido proporcionado.
Ejemplo #1 Ejemplo 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 (usar por defecto)
?>Resultado del ejemplo anterior es similar a:
int(1) int(10)
Ejemplo #2 Ejemplo de Ds\Map::get() utilizando la sintaxis de array
<?php
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
var_dump($map["a"]); // 1
?>Resultado del ejemplo anterior es similar a:
int(1)