Extracted from Pike v8.0 release 240 as of 2016-05-31.
   

Method Gdbm.DB()->firstkey()


Method firstkey

string firstkey()

Description

Return the first key in the database, this can be any key in the database.

Used together with nextkey the databse can be iterated.

Note

The database also works as an Iterator, and can be used as the first argument to foreach.

Adding or removing keys will change the iteration order, this can cause keys to be skipped while iterating.

Example

// Write the contents of the database for(key=gdbm->firstkey(); k; k=gdbm->nextkey(k)) write(k+":"+gdbm->fetch(k)+"\n");

Or, using foreach

// Write the contents of the database foreach( db; string key; string value ) write(key+":"+value+"\n");