Overview
KB
Technical FAQ
PHP Manual
CSS2 Manual
HTML Manual
JS Guide
JS Reference
PhpDock Manual
Nu-Coder Manual
PhpExpress Manual
PHP Joomla
Development
Learn PHP
 
<Ds\Stack::jsonSerializeDs\Stack::pop>
^Ds\StackLast updated: Mon, 26 Oct 2026

Ds\Stack::peek

(PECL ds >= 1.0.0)

Ds\Stack::peek — Returns the value at the top of the stack

Description

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

Returns the value at the top of the stack, but does not remove it.

Parameters

This function has no parameters.

Return Values

The value at the top of the stack.

Errors/Exceptions

UnderflowException if empty.

Examples

Example #1 Ds\Stack::peek() example

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

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

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

The above example will output something similar to:

string(1) "c"

<Ds\Stack::jsonSerializeDs\Stack::pop>
^Ds\StackLast updated: Mon, 26 Oct 2026