Ds\Stack::peek

(PECL ds >= 1.0.0)

Ds\Stack::peek — Возвращает значение с вершины стека

Описание

public Ds\Stack::peek ( void ) : mixed

Возвращает значение с вершины стека, но не удаляет его.

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

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

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

Значение с вершины стека.

Ошибки

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

Примеры

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

<?php
$stack = new \Ds\Stack();

$stack->push("a");
$stack->push("b");
$stack->push("c");

var_dump($stack->peek());
?>

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

string(1) "c"