在线文档教程
PHP
数据结构 | Data Structures

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

可选的默认值,如果找不到密钥则返回。

返回值

映射到给定keydefault值,或者提供的值和在映射中找不到的键。

错误/异常

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 →