DatabaseConnection::nextId
abstract public function DatabaseConnection::nextId
abstract public DatabaseConnection::nextId($existing_id = 0)
Retrieves an unique id from a given sequence.
Use this function if for some reason you can't use a serial field. For example, MySQL has no ways of reading of the current value of a sequence and PostgreSQL can not advance the sequence to be larger than a given value. Or sometimes you just need a unique integer.
Parameters
$existing_id: After a database import, it might be that the sequences table is behind, so by passing in the maximum existing id, it can be assured that we never issue the same id.
Return value
An integer number larger than any number returned by earlier calls and also larger than the $existing_id if one was passed in.
File
- includes/database/database.inc, line 1315
- Core systems for the database layer.
Class
- DatabaseConnection
- Base Database API class.
Code
abstract public function nextId($existing_id = 0);
© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/includes!database!database.inc/function/DatabaseConnection::nextId/7.x