Ds\Map::get
(PECL ds >= 1.0.0)
Ds\Map::get — Retorna o valor para uma chave dada
Descrição
Retorna o valor para uma chave dada, ou um valor padrão opcional se a chave não puder ser encontrada.
Nota:
Chaves do tipo object são suportadas. Se um objeto implementa Ds\Hashable, a igualdade será determinada pela função
equalsdo objeto. Se um objeto não implementa Ds\Hashable, os objetos devem ser referências à mesma instância para serem considerados iguais.
Nota:
Você também pode usar a sintaxe de array para acessar valores por chave, por exemplo,
$map["key"].
Tenha cuidado ao usar a sintaxe de array. Chaves escalares serão convertidas para
inteiros pelo interpretador. Por exemplo, $map["1"] tentará
acessar int(1), enquanto $map->get("1") procurará
corretamente a chave de string.
Veja Arrays.
Parâmetros
-
key -
A chave para procurar.
-
default -
O valor padrão opcional, retornado se a chave não puder ser encontrada.
Valor Retornado
O valor associado à key dada, ou o valor default
se fornecido e a chave não puder ser encontrada no mapa.
Erros/Exceções
OutOfBoundsException se a chave não puder ser encontrada e um valor padrão não foi fornecido.
Exemplos
Exemplo #1 Ds\Map::get() exemplo
<?php
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
var_dump($map->get("a")); // 1
var_dump($map->get("d", 10)); // 10 (default used)
?>O exemplo acima produzirá algo semelhante a:
int(1) int(10)
Exemplo #2 Exemplo de Ds\Map::get() usando a sintaxe de array
<?php
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
var_dump($map["a"]); // 1
?>O exemplo acima produzirá algo semelhante a:
int(1)
add a note
