dbm_firstkey Subroutine

Purpose

Returns the first key in a database.

Library

C Library (libc.a)

Syntax

#include <ndbm.h>
datum dbm_firstkey ( db)
DBM *db;

Description

The dbm_firstkey subroutine returns the first key in a database.

Parameters

Item Description
db Specifies the database to access.

Return Values

Upon successful completion, this subroutine returns a datum structure containing the value returned for the specified key. If the subroutine is unsuccessful, a null value is indicated in the dptr field of the datum structure.