Ds\Map::get

(PECL ds >= 1.0.0)

Ds\Map::get — Возвращает значение по ключу

Описание

public mixed Ds\Map::get ( mixed $key [, mixed $default ] )

Возвращает значение по заданному ключу, или, опционально, заданное значение по умолчанию, если ключ не найден.

Замечание:
Поддерживаются значения типа object. Если объект реализует интерфейс Ds\Hashable, проверка производится путем вызова метода объекта equals. Если объект не реализует интерфейс Ds\Hashable, объекты должны ссылаться на один и тот-же экземпляр класса.

Замечание:
Вы можете использовать синтаксис массива для доступа к значениям, т.е. $map["key"].

Предостережение

Будьте осторожны используя синтаксис массива. Скалярные ключи будут приведены к целым ядром PHP. К примеру, $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 (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)