Home › API reference › database.inc

db_next_id

  1. drupal
    1. 4.7 database.mysql.inc
    2. 4.7 database.mysqli.inc
    3. 4.7 database.pgsql.inc
    4. 5 database.mysqli.inc
    5. 5 database.mysql.inc
    6. 5 database.pgsql.inc
    7. 7
Versions
4.7 – 5 db_next_id($name)
7 db_next_id($existing_id = 0)

Retrieves a unique id.

Use this function if for some reason you can't use a serial field. Using a serial field is preferred, and InsertQuery::execute() returns the value of the last ID inserted.

Parameters

$existing_id After a database import, it might be that the sequences table is behind, so by passing in a minimum ID, it can be assured that we never issue the same ID.

Return value

An integer number larger than any number returned before for this sequence.

Related topics

Database abstraction layer
Allow the use of different database servers using the same code base.

▸ 3 functions call db_next_id()

▾ 3 functions call db_next_id()

actions_save in drupal/includes/actions.inc
Saves an action and its user-supplied parameter values to the database.
batch_process in drupal/includes/form.inc
Processes the batch.
user_save in drupal/modules/user/user.module
Save changes to a user account or add a new user.

Code

drupal/includes/database/database.inc, line 2524

<?php
function db_next_id($existing_id = 0) {
  return Database::getConnection()->nextId($existing_id);
}
?>