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

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.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The firstkey subroutine.

List of NDBM and DBM Programming References and NDBM Overview in AIX Version 4.3 Communications Programming Concepts.