PEAR Manual
PrevNext

DB_common::nextId()

DB_common::nextId() -- Returns the next free id of a sequence

Synopsis

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 DB_Error, if fail

Throws

Table 21-1. Possible PEAR_Error values

Error codeError messageReasonSolution
DB_ERROR_NOT_CAPABLE NULL Function is not supported by the database backend Switch to another database system, if you really need this feature.
DB_ERROR_NOT_LOCKED NULL Locking of sequence table fails Database specific, check documentation of your database,
DB_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
DB_common::limitQuery()UpDB_common::prepare()