What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.

dba_insert
Prev	XIV. DBA (dbm-style Database Abstraction) Functions	Next

dba_insert

Name

dba_insert — Inserts a new key-value pair into the db file.

Synopsis

bool dba_insert(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_insert() inserts new key-value pairs into a db file. If the key-value pair is successfully inserted, the function returns TRUE. If the key specified in the key argument already exists, the operation fails and returns FALSE.

Version

PHP Version: 3.0.8+, 4.0b2+

Example

Example 215. Insert a new key-value pair

$key = 'love';

dba_insert ($key, 'hate', $dba_handle)
    or die ("A new key-value pair could not be created.
        It is likely that the key <i>$key</i> already exists in the database.");

Prev	Home	Next
dba_firstkey	Up	dba_nextkey

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.