PEAR Manual
PrevNext

MDB_Common::nextId()

MDB_Common::nextId() -- returns the next free id of a sequence

Synopsis

require_once 'MDB.php';

resource nextId (string $seq_name, boolean $onDemand = TRUE)

Description

See "Introduction - Sequences"

Parameter

string $seq_name

name of the sequence

boolean $onDemand

when TRUE the sequence is automatic created, if it not exists.

Return value

resource - a free id or a MDB_Error, if fail

Throws

Table 26-1. Possible PEAR_Error values

Error codeError messageReasonSolution
MDB_ERROR_NOT_CAPABLE NULL Function is not supported by the database backend Switch to another database system, if you really need this feature.
MDB_ERROR_NOT_LOCKED NULL Locking of sequence table fails Database specific, check documention of your database,
MDB_ERROR_NOSUCHTABLE NULL Sequence table was not found Try to create a new sequence or if you are sure, a sequence was already create, check database integrity

Note

This function can not be called statically.

See

createSequence() , dropSequence()

PrevHomeNext
MDB_Common::limitQuery()UpMDB_Common::numCols()