The Open Group Base Specifications Issue 6
IEEE Std 1003.1, 2003 Edition
Copyright © 2001-2003 The IEEE and The Open Group, All Rights reserved.

NAME

ndbm.h - definitions for ndbm database operations

SYNOPSIS

[XSI] [Option Start] #include <ndbm.h> [Option End]

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> .


The following sections are informative.

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.

End of informative text.


UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
[ Main Index | XBD | XCU | XSH | XRAT ]