array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'ds-stack.peek.php', 1 => 'Ds\\Stack::peek', 2 => 'Возвращает значение с вершины стека', ), 'up' => array ( 0 => 'class.ds-stack.php', 1 => 'Ds\\Stack', ), 'prev' => array ( 0 => 'ds-stack.jsonserialize.php', 1 => 'Ds\\Stack::jsonSerialize', ), 'next' => array ( 0 => 'ds-stack.pop.php', 1 => 'Ds\\Stack::pop', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/ds/ds/stack/peek.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Ds\Stack::peek

(PECL ds >= 1.0.0)

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

Описание

public Ds\Stack::peek(): 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"