dbm_store() -- NDBM Function (libgdbm)

Store a record into an NDBM data base
#include <ndbm.h>
int dbm_store (database, key, content, flags)
DBM *database;
datum key, content;
int flag;

Function dbm_store() inserts a  record into database, which must first have
been  opened by  a call  to dbm_open().  content points to  the data  to be
stored within the data base; and key points to the key under which the data
are to be stored.

flag indicates how the the data  are to be inserted into the data base.  If
it is  set to DBM_INSERT, the  data are appended onto the  data base as new
records; in  this case, dbm_store()  will not modify  existing records that
have an  identical key. If, however, you set  flag to DBM_REPLACE, contents
replaces any existing record with an identical key.

If all  goes well, dbm_store()  returns zero.  It returns  a negative value
should an error occur.  If you set flag to DBM_INSERT and dbm_store() finds
that database already contains a record with key, it returns one.

See Also


Notes

For  a statement  of copyright  and  permissions on  this routine,  see the
Lexicon entry for libdbm.

© 2012 by Stephen A. Ness