->insert()

Description

Insert the data into the database, based on the variable values of the current object and returns the ID of the inserted element if sequences or primary keys are being used. The values are correctly quoted, and some limited type checking is done.

With mysql, the mysql_next_id() method is used, on other databases, PEAR DB sequence method is used.

Return value

mixed - Id or key

Throws

Note

This function can not be called statically.

Example

$person = new DataObjects_Person;
$person->name='fred';
$id = $person->insert();

INSERT INTO person (name) VALUES ('fred');