Description
bool dba_insert(stringarray $key, string $value, Dba\Connection $dba)
dba_insert inserts the entry described with
key and value into the
database.
Parameters
-
key
-
The key of the entry to be inserted. If this key already exists in the
database, this function fails. Use dba_replace
if you need to replace an existing key.
The
inifile and cdb_make handlers
are the exception: they add another entry with the same key and return
true. With inifile, use the skip
parameter of dba_fetch to read it.
-
value
-
The value to be inserted.
-
dba
-
A Dba\Connection instance, returned by dba_open or dba_popen.
Return Values
Returns true on success or false on failure.
Errors/Exceptions
If dba was opened read-only (mode r),
an E_WARNING is raised and false is returned.
See Also
- dba_exists
- dba_delete
- dba_fetch
- dba_replace