php man page for mysql_list_tables

MYSQL_LIST_TABLES(3)							 1						      MYSQL_LIST_TABLES(3)

mysql_list_tables - List tables in a MySQL database

SYNOPSIS
       Warning

	      This  function  was deprecated in PHP 4.3.0, and will be removed in the future, along with the entirety of the original MySQL exten-
	      sion. Instead, the MySQLi or PDO_MySQL extension should be used. See also MySQL: choosing an API guide  and  related  FAQ  for  more
	      information. Alternatives to this function include:

		     oSQL Query:
		       SHOW TABLES FROM sometable

       resource mysql_list_tables (string  $database, [resource  $link_identifier = NULL])

DESCRIPTION
	Retrieves a list of table names from a MySQL database.

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

	      o $database
		- The name of the database

	      o $
		link_identifier -The MySQL connection. If the link identifier is not specified,  the  last  link  opened  by  mysql_connect(3)	is
		assumed. If no such link is found, it will try to create one as if mysql_connect(3) was called with no arguments. If no connection
		is found or established, an E_WARNING level error is generated.

	A result pointer resource on success or FALSE on failure.

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

       +--------+-----------------------------------+
       |Version |				    |
       |	|				    |
       |	|	     Description	    |
       |	|				    |
       +--------+-----------------------------------+
       | 4.3.7	|				    |
       |	|				    |
       |	|  This function became deprecated. |
       |	|				    |
       +--------+-----------------------------------+
       Example #1

	      mysql_list_tables(3) 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
";
		  echo 'MySQL Error: ' . mysql_error();
		  exit;
	      }

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

	      mysql_free_result($result);
	      ?>

       Note

	       For backward compatibility, the following deprecated alias may be used: mysql_listtables(3)

       mysql_list_dbs(3), mysql_tablename(3).

PHP Documentation Group 												      MYSQL_LIST_TABLES(3)