mysql_list_fields

(PHP 4, PHP 5, PECL mysql:1.0)

mysql_list_fields — Lista os campos de uma tabela MySQL

Descrição

resource mysql_list_fields ( string $database_name , string $table_name [, resource $link_identifier ] )

Obtém informações sobre o nome de tabela dado.

Esta função esta obsoleta. É preferrível usar mysql_query() para realizar uma consulta SQL SHOW COLUMNS FROM table [LIKE 'name'] ao invés.

Parâmetros

database_name: O nome do banco de dados que esta sendo consultado.
table_name: O nome da tabela que esta sendo consultada.
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.

Valor Retornado

Um ponteiro de recurso resource em caso de sucesso, ou FALSE em caso de falha.

O ponteiro de resultado pode ser usado com mysql_field_flags(), mysql_field_len(), mysql_field_name() e mysql_field_type().

Exemplos

Example#1 Alternativa para o obsoleto mysql_list_fields()


<?php
$result = mysql_query("SHOW COLUMNS FROM sometable");
if (!$result) {
    echo 'Could not run query: ' . mysql_error();
    exit;
}
if (mysql_num_rows($result) > 0) {
    while ($row = mysql_fetch_assoc($result)) {
        print_r($row);
    }
}
?>

O exemplo acima irá imprimir algo similar a:

Array
(
    [Field] => id
    [Type] => int(7)
    [Null] =>  
    [Key] => PRI
    [Default] =>
    [Extra] => auto_increment
)
Array
(
    [Field] => email
    [Type] => varchar(100)
    [Null] =>
    [Key] =>
    [Default] =>
    [Extra] =>
)

Notas

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

Veja também