Manual do PHP
Anterior |  | Próxima

# mysql_list_dbs

(PHP 3, PHP 4, PHP 5)

mysql_list_dbs -- Lista os bancos de dados disponíveis em um servidor MySQL

## Descrição

resource mysql_list_dbs ( [resource link_identifier] )

Retorna um ponteiro de resultado contendo od banco de dados disponíveis atualmente no servidor MySQL.

## Parâmetros

`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

Retorna um ponteiro de 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 com resultados, como mysql_fetch_array().

## Exemplos

Exemplo 1. Exemplo mysql_list_dbs()

`<?php $link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); $db_list = mysql_list_dbs($link); while ($row = mysql_fetch_object($db_list)) { echo $row->Database . "\n"; } ?>`

O exemplo acima irá imprimir algo similar a:

    database1
    database2
    database3

## Notas

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

## Veja também

mysql_db_name()
mysql_select_db()

Anterior | Principal | Próxima
mysql_insert_id | Acima | mysql_list_fields