mysql_list_tables

List tables in a MySQL database

&mysql.alternative.note.4-3-0;

- SQL Query: `SHOW TABLES FROM dbname`

&reftitle.description; ``resource``false```mysql_list_tables` `string` `database` `resource` `link_identifier` NULL

Retrieves a list of table names from a MySQL database.

This function is deprecated. It is preferable to use `mysql_query` to issue an SQL `SHOW TABLES [FROM db_name] [LIKE 'pattern']` statement instead.

&reftitle.parameters;

`database`

- The name of the database

&mysql.linkid.description;
&reftitle.returnvalues;

A result pointer `resource` on success&return.falseforfailure;.

Use the `mysql_tablename` function to traverse this result pointer, or any function for result tables, such as `mysql_fetch_array`.

&reftitle.examples;

### `mysql_list_tables` alternative example

    <?php
    $dbname = 'mysql_dbname';

    if (!mysql_connect('mysql_host', 'mysql_user', 'mysql_password')) {
        echo 'Could not connect to mysql';
        exit;
    }

    $sql = "SHOW TABLES FROM $dbname";
    $result = mysql_query($sql);

    if (!$result) {
        echo "DB Error, could not list tables\n";
        echo 'MySQL Error: ' . mysql_error();
        exit;
    }

    while ($row = mysql_fetch_row($result)) {
        echo "Table: {$row[0]}\n";
    }

    mysql_free_result($result);
    ?>

&reftitle.notes;

&info.deprecated.alias; `mysql_listtables`

&reftitle.seealso;

- `mysql_list_dbs`
- `mysql_tablename`