store() -- DBM Function (libgdbm)

Write a record into a DBM data base
#include <dbm.h>
int store(key, datum)
datum key, datum;

Function store()  writes a  record into the  currently open DBM  data base.
The data base must first have been opened by a call to dbminit().

key points  to the key by  which the datum is  identified.  datum points to
the datum  itself.  If the  data base already  contains a record  with key,
store() overwrites it.

The sizes of key and datum together must not exceed BSIZE bytes -- that is,
the  size of  one  file-system block.   (BSIZE  is defined  in header  file
<sys/buf.h>.)

If all goes  well, store() returns zero.  If an  error occurs, it returns a
negative value.

See Also


Notes

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

© 2012 by Stephen A. Ness