PHP Conference Nagoya 2025

dba_firstkey

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

dba_firstkeyFetch first key

Description

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

add a note

User Contributed Notes 3 notes

up
0
jacky dot jackyhung dot net
22 years ago
for ($key = dba_firstkey($this->handle); $key !== false; $key = dba_nextkey($this->handle)) {
$keyset[] = $key;
} // end for
up
-1
rcracer91 at gmail dot com
15 years ago
I wondered why it wasn't already written, so I did because I think working with associative arrays is always as comfortable as can be

<?php
function dba_fetch_assoc($handle) {
$assoc = array();
for(
$k = dba_firstkey($handle); $k != false; $k = dba_nextkey($handle)) {
$assoc[$k] = dba_fetch($k, $handle);
}
return
$assoc;
}
?>
up
-1
psycho-logic at excite dot com
21 years ago
Looks like Jacky is using some DB object? I don't know if it's native to PHP or written on it's own... Anyways this is what I use:

$DBCon = dba_open("/tmp/test_db.db2", "r", "db2") or die("Uh oh, can't open the database :(");
if ($the_key = dba_firstkey($DBCon)) do {
print("Key: $the_key Value:");
print dba_fetch($the_key, $DBCon);
print("<BR>");
} while ($the_key = dba_nextkey($DBCon));
print ("<BR><BR><BR>Well looks like we're done here :-)");
To Top