Put a key-value pair into the database. The database is identified by the first argument, DB and should contain the unaltered value returned by the function bdb::Open.
The arguments key and value can be arbitrary strings containing ASCII or binary data. The argument flag is optional. Its value other than zero can be some of the following constants defined in bdb.bas connected using the numeric operator And:
- Bdb::Append This flag should only be used on Recno databases. Because this type is currently not supported you better do not use this constant.
- Bdb::NoOverWrite This value specifies that the key and value should only be put into the database if the key is not present in the database yet. If the key already appears in the database an error is raised that the program can handle using the On Error Goto statement. The error code is bdb::ErrorKeyExist.