Ds\Map::get
Ds\Map::get
(PECL ds >= 1.0.0)
Ds\Map::get — 返回给定键的值。
描述
public mixed Ds\Map::get ( mixed $key [, mixed $default ] )
返回给定键的值,如果找不到键,则返回可选的默认值。
注意
:支持类型对象的键。如果一个对象实现了Ds \ Hashable
,则等式将由该对象的equals
函数决定。如果一个对象没有实现Ds \ Hashable
,则对象必须是对同一个实例的引用才能被视为相等。
注意
:您也可以使用数组语法通过键访问值,例如。$map["key"]
。
警告
使用数组语法时要小心。标量键将被引擎强制为整数。例如,$map["1"]会尝试访问int(1),同时$map->get("1")会正确查找字符串键。
见数组。
参数
key
查找的关键。
default
可选的默认值,如果找不到密钥则返回。
返回值
映射到给定key
的default
值,或者提供的值和在映射中找不到的键。
错误/异常
OutOfBoundsException如果找不到密钥并且未提供默认值。
例子
示例#1Ds\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)
?>
上面的例子会输出类似于:
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)
← Ds\Map::first
Ds\Map::hasKey →