Home » API reference » Drupal 6 » database.mysql-common.inc

db_rename_table

6 database.mysql-common.inc db_rename_table(&$ret, $table, $new_name)
6 database.pgsql.inc db_rename_table(&$ret, $table, $new_name)
7 database.inc db_rename_table($table, $new_name)
8 database.inc db_rename_table($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.

47 functions call db_rename_table()

File

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

Code

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