array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'ds-map.remove.php', 1 => 'Ds\\Map::remove', ), 'up' => array ( 0 => 'class.ds-map.php', 1 => 'Ds\\Map', ), 'prev' => array ( 0 => 'ds-map.reduce.php', 1 => 'Ds\\Map::reduce', ), 'next' => array ( 0 => 'ds-map.reverse.php', 1 => 'Ds\\Map::reverse', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/ds/ds/map/remove.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PECL ds >= 1.0.0)
Ds\Map::remove — Remove e retorna um valor pela chave
Remove e retorna um valor pela chave, ou retorna um valor padrão opcional se a chave não puder ser encontrada.
Nota:
Chaves do tipo object são suportadas. Se um objeto implementar Ds\Hashable, a igualdade será determinada pela função
equals
do objeto. Se um objeto não implementar Ds\Hashable, 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 pela chave, por exemplo,
$map["key"]
.
Tenha cuidado ao usar a sintaxe de array. Chaves escalares serão convertidas para
inteiros pelo motor. Por exemplo, $map["1"]
tentará
acessar int(1)
, enquanto $map->get("1")
irá
corretamente procurar a chave de string.
Veja Arrays.
key
A chave a ser removida.
default
O valor padrão opcional, retornado se a chave não puder ser encontrada.
O valor que foi removido, ou o valor default
se fornecido e a key
não puder ser encontrada no mapa.
OutOfBoundsException se a chave não puder ser encontrada e um valor padrão não foi fornecido.
Exemplo #1 Ds\Map::remove() exemplo
<?php
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
var_dump($map->remove("a")); // 1
var_dump($map->remove("e", 10)); // 10 (default used)
?>
O exemplo acima produzirá algo semelhante a:
int(1) int(10)