Ds\Map::first

(PECL ds >= 1.0.0)

Ds\Map::first — Возвращает первый элемент коллекции

Описание

public Ds\Map::first ( void ) : Ds\Pair

Возвращает первый элемент коллекции.

Список параметров

У этой функции нет параметров.

Возвращаемые значения

Первый элемент коллекции.

Ошибки

Выбрасывает исключение UnderflowException, если коллекция пуста.

Примеры

Пример #1 Пример использования Ds\Map::first()

<?php
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
var_dump($map->first());
?>

Результатом выполнения данного примера будет что-то подобное:

object(Ds\Pair)#2 (2) {
  ["key"]=>
  string(1) "a"
  ["value"]=>
  int(1)
}