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\Map::filterDs\Map::get>
^Ds\MapLast updated: Mon, 26 Oct 2026

Ds\Map::first

(PECL ds >= 1.0.0)

Ds\Map::first — Returns the first pair in the map

Description

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

Returns the first pair in the map.

Parameters

This function has no parameters.

Return Values

The first pair in the map.

Errors/Exceptions

UnderflowException if empty.

Examples

Example #1 Ds\Map::first() example

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

The above example will output something similar to:

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

<Ds\Map::filterDs\Map::get>
^Ds\MapLast updated: Mon, 26 Oct 2026