Fetch first key

# dba_firstkey

(PHP 4, PHP 5, PHP 7, PHP 8)

dba_firstkey — Fetch first key

### Description

function dba_firstkey(Dba\Connection `$dba`): string|false

dba_firstkey() returns the first key of the database and resets the internal key pointer. This permits a linear search through the whole database.

### Parameters

`dba`
  A Dba\Connection instance, returned by dba_open() or dba_popen().

### Return Values

Returns the key on success or `false` on failure.

### Changelog

Version | Description
--- | ---
8.4.0 | The `dba` parameter expects a Dba\Connection instance now; previously, a valid `dba` resource was expected.

### See Also

- dba_nextkey() - Fetch next key
- dba_key_split() - Splits a key in string representation into array representation
- Example 2 in the DBA examples

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open