NAME

ndbm.h - definitions for ndbm database operations

SYNOPSIS

^[XSI] #include <ndbm.h>

DESCRIPTION

The <ndbm.h> header shall define the datum type as a structure that includes at least the following members:

void   *dptr  A pointer to the application's data. 
size_t  dsize The size of the object pointed to by dptr. 

The size_t type shall be defined as described in <stddef.h> .

The <ndbm.h> header shall define the DBM type.

The following constants shall be defined as possible values for the store_mode argument to dbm_store():

DBM_INSERT

Insertion of new entries only.

DBM_REPLACE

Allow replacing existing entries.

The following shall be declared as functions and may also be defined as macros. Function prototypes shall be provided.

int     dbm_clearerr(DBM *);
void    dbm_close(DBM *);
int     dbm_delete(DBM *, datum);
int     dbm_error(DBM *);
datum   dbm_fetch(DBM *, datum);
datum   dbm_firstkey(DBM *);
datum   dbm_nextkey(DBM *);
DBM    *dbm_open(const char *, int, mode_t);
int     dbm_store(DBM *, datum, datum, int);

The mode_t type shall be defined through typedef as described in <sys/types.h> .

APPLICATION USAGE

None.

RATIONALE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

<stddef.h> , <sys/types.h> , the System Interfaces volume of IEEE Std 1003.1-2001, dbm_clearerr()

CHANGE HISTORY

First released in Issue 4, Version 2.

Issue 5

References to the definitions of size_t and mode_t are added to the DESCRIPTION.