dba_replace

(PHP 4, PHP 5, PHP 7, PHP 8)

dba_replace — Replace or insert entry

Description

function dba_replace(string|array $key, string $value, Dba\Connection $dba): bool

dba_replace() replaces or inserts the entry described with key and value into the database specified by dba.

Parameters

key

The key of the entry to be replaced.

value

The value to be replaced.

dba

A Dba\Connection instance, returned by dba_open() or dba_popen().

Return Values

Returns true on success or false on failure.

The cdb_make handler cannot replace entries, so with it this function always returns false.

Errors/Exceptions

If dba was opened read-only (mode r), an E_WARNING is raised and false is returned.

Changelog

Version Description
8.4.0 The dba parameter expects a Dba\Connection instance now; previously, a valid dba resource was expected.

See Also