PHP Conference Nagoya 2025

Ds\Map::get

(PECL ds >= 1.0.0)

Ds\Map::getRetorna o valor para uma chave dada

Descrição

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

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 equals do objeto. Se um objeto não implementa Ds\Hashable, os objetos devem ser referências à mesma instância para serem considerados iguais.

Nota:

Pode ser usada a sintaxe de array para acessar valores por chave, por exemplo, $map["key"].

Cuidado

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 a ser procurada.

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 Exemplo 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 (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)
adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top