dba_replace
Name
dba_replace — Replaces the value of an existing
key-value pair (or inserts a new key-value pair) in the
database.
Synopsis
bool dba_replace(key, value,
dba_resource);
string key: Key to
insert
string value: Value to
associate with the key
resource dba_resource:
Resource handle opened by dba_open() or dba_popen()
Returns
TRUE on success; FALSE on failure
Description
dba_replace() replaces or inserts a key-value pair
in a db file. If the key-value pair exists, the value is
overwritten with the value contained in the value argument. If the key doesn't exist,
the function behaves like dba_insert() , adding a new
key-value pair to the database.
If a pair is successfully replaced or inserted, the
function returnsTRUE. In all other cases, the function
fails and returnsFALSE.
Version
PHP Version: 3.0.8+, 4.0b2+
Example
Example 220. Replace or
insert a key-value pair
$key = 'Freud';
dba_insert ($key, 'Sigmund', $dba_handle)
or die ("The key-value pair could not be created or replaced.
It is likely that something bad has happened.");
PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing
(Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch).
This material may be distributed only subject to the terms and conditions set forth
in the Open Publication License, v1.0 or later (the latest version is presently available at
http://www.opencontent.org/openpub/).
The authors of this book have elected not to choose any options under the OPL. This online book was obtained
from
http://www.fooassociates.com/phpfer/
and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4
for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All
persons and entities shall have neither liability nor responsibility to any person or entity with respect to
any loss or damage arising from the information contained in this book.
PhpDig.net