(PECL ds >= 1.0.0)
Ds\Map::get — 返回给定键的值
返回给定键的值,如果找不到键,则返回可选的默认值。
注意:
支持对象类型的键。如果对象实现了Ds\Hashable,则相等性将由对象的
equals
函数确定。如果对象没有实现Ds\Hashable,则对象必须是同一个实例的引用才能被认为是相等的。
注意:
您也可以使用数组语法通过键访问值,例如
$map["key"]
。
使用数组语法时要小心。标量键将被引擎强制转换为整数。例如,$map["1"]
将尝试访问 int(1)
,而 $map->get("1")
将正确查找字符串键。
参见 数组。
key
要查找的键。
default
可选的默认值,如果找不到键则返回。
映射到给定key
的值,如果提供了default
值且在映射中找不到键,则返回该值。
如果找不到键且未提供默认值,则为OutOfBoundsException。
示例 #1 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 (使用默认值)
?>
以上示例将输出类似于以下内容
int(1) int(10)
示例 #2 使用数组语法的 Ds\Map::get() 示例
<?php
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
var_dump($map["a"]); // 1
?>
以上示例将输出类似于以下内容
int(1)