Manual do PHP
Anterior |  | Próxima

# mysql_list_tables

(PHP 3, PHP 4, PHP 5)

mysql_list_tables -- Lista as tabelas em um banco de dados MySQL

## Descrição

resource mysql_list_tables ( string database [, resource link_identifier] )

Obtém uma lista dos nomes das tabelas de um banco de dados MySQL.

Esta função esta obsoleta. É preferrível usar mysql_query() para fazer uma consulta SQL `SHOW TABLES [FROM db_name] [LIKE 'pattern']` ao invés.

## Parâmetros

`database`

  O nome do banco de dados

`link_identifier`

  A conexão MySQL. se o identificador de conexão não for especificado, a ultima conexão aberta por mysql_connect() é assumida. Se uma conexão assim não for encontrada, ela irá tentar criar uma como se a função mysql_connect() fosse chamada sem argumentos. Se uma conexão não for encontrada ou estabelecida, um aviso de nível `E_WARNING` é gerado.

## Valores de retornado

Um ponteiro do tipo resultado resource em caso de sucesso, ou `FALSE` em caso de falha.

Use a função mysql_tablename() para lidar com este ponteiro de resultado, ou qualquer função para tabelas de resultado, como mysql_fetch_array().

## Exemplos

Exemplo 1. Exemplo alternativo de mysql_list_tables()

`<?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);
?>`

## Notas

> Nota: Para compatibilidade com versões anteriores, o seguinte apelido obsoleto pode ser usado: mysql_listtables()

## Veja também

mysql_list_dbs()
mysql_tablename()

Anterior | Principal | Próxima
mysql_list_processes | Acima | mysql_num_fields