What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.

dba_firstkey
Prev	XIV. DBA (dbm-style Database Abstraction) Functions	Next

dba_firstkey

Name

dba_firstkey — Fetches the first key in the db file.

Synopsis

mixed dba_firstkey(dba_handle); resource dba_handle: Resource handle opened by dba_open() or dba_popen()

Returns

The first key in the db file; FALSE on failure

Description

dba_firstkey() resets the db pointer to the start of the db file and returns the name of the first key in the db file. If the key cannot be read, the function returns FALSE.

This function is most often used with dba_nextkey() to iterate over each key-value pair in the db file.

Version

PHP Version: 3.0.8+, 4.0b2+

Example

Example 214. Display every key-value pair in a db file

<pre>
<?php
$db_file = '/tmp/passwords.db';
$dba_handle = dba_open ($db_file, 'n', 'gdbm')
    or die ("File <i>$db_file</i> could not be opened, does not exist, or is not a db file.");

$key = dba_firstkey ($dba_handle)

if ($key === FALSE)
    die ("The first key could not be read from file <i>$db_file</i>.");

while ($key !== FALSE) {
    printf ("%-'.16s..%'.16s\n", "<b>$key</b>", dba_fetch ($key, $dba_handle));
    $key = dba_nextkey ($dba_handle);
}
?>
</pre>

Prev	Home	Next
dba_fetch	Up	dba_insert

PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.