function db_rename_table

7.x database.inc db_rename_table($table, $new_name)
6.x database.pgsql.inc db_rename_table(&$ret, $table, $new_name)
6.x database.mysql-common.inc db_rename_table(&$ret, $table, $new_name)

Rename a table.

Parameters

$ret: Array to which query results will be added.

$table: The table to be renamed.

$new_name: The new name for the table.

Related topics

Schema API
A Drupal schema definition is an array structure representing one or more tables and their related keys and indexes. A schema is defined by hook_schema(), which usually lives in a modulename.install file.
2 calls to db_rename_table()
system_update_6022 in drupal-6.x/modules/system/system.install
Update files tables to associate files to a uid by default instead of a nid. Rename file_revisions to upload since it should only be used by the upload module used by upload to link files to nodes.
system_update_6030 in drupal-6.x/modules/system/system.install
Add the tables required by actions.inc.

File

drupal-6.x/includes/database.mysql-common.inc, line 257
Functions shared between mysql and mysqli database engines.

Code

function db_rename_table(&$ret, $table, $new_name) {
  $ret[] = update_sql('ALTER TABLE {' . $table . '} RENAME TO {' . $new_name . '}');
}