(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
值并且在映射中找不到键,则返回 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)