Manual do PHP
Anterior |  | Próxima

# mysql_list_fields

(PHP 3, PHP 4, PHP 5)

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.

## Valores de 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

Exemplo 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

mysql_field_flags()
mysql_info()

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