Back to Hhvm

FirstValue

hphp/hack/manual/apis/Classes/HH/Map/firstValue.md

latest1013 B
Original Source

:::info[Note] This is a point-in-time snapshot of the API documentation from January 2026. Going forward, we will not be maintaining a public copy of these references, and recommend users to refer to the built-in signature helpers available in the Hack LSP instead for complete and up-to-date information. :::

Returns the first value in the current Map

Hack
public function firstValue(): ?Tv;

Returns

  • ?Tv - The first value in the current Map, or null if the Map is empty.

Examples

The following example gets the first value from a Map. An empty Map will return null as its first value.

basic-usage.hack
$m = Map {
  'red' => '#ff0000',
  'green' => '#00ff00',
  'blue' => '#0000ff',
  'yellow' => '#ffff00',
};
\var_dump($m->firstValue());

$m = Map {};
\var_dump($m->firstValue());
<!-- HHAPIDOC -->