Ds\Map::get

(PECL ds >= 1.0.0)

Ds\Map::get返回给定键的值

描述

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

返回给定键的值,如果找不到键,则返回可选的默认值。

注意:

支持类型为 对象 的键。如果一个对象实现了 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)
添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top