gdbm_store() -- GDBM Function (libgdbm)

Add records to a GDBM data base
#include <gdbm.h>
int gdbm_store (database, key, content, flag)
GDBM_FILE database;
datum key, content;
int flag;

Function gdbm_store() writes data into a GDBM data base.

database points to the data base into which data are written.  It must have
been returned by a call to gdbm_open().

key gives the key for the  record being written.  content gives the data to
be associated with key.

flag  indicates  how data  should  be  written; it  can  be  either of  the
following:

GDBM_INSERT
     Insert only.  If database already contains a record with key, generate
     an error.

GDBM_REPLACE
     Update.  If  database already contains  a record with  key, replace it
     with with contents.

If all  goes well, gdbm_store() returns zero.  If  database was opened into
read-only mode, it returns -1.  If  flag is set to GDBM_INSERT and database
already contains key, it returns one.

See Also


Notes

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

© 2012 by Stephen A. Ness