mysql_fetch_field

(PHP 3, PHP 4, PHP 5)

mysql_fetch_field -- Obtém informações sobre uma coluna de um resultado e retorna como um objeto

Descrição

object mysql_fetch_field ( resource result [, int field_offset] )

Retorna um objeto contendo informações sobre o campo. Esta função pode ser usada para obter informações sobre os campos de um resultado de uma consulta.

Parâmetros

result

O resulatado resource que esta sendo avaliado. Este resultado vem de uma chamada a mysql_query().

field_offset

O índice numérico do campo. Se o índice não for especificado, o próximo campo que não tenha sido obtido por esta função é retornado. O parâmetro field_offset começa em 0.

Valores de retornado

Retorna um object contendo a informação sobre o campo. As propriedades do objeto são:

Exemplos

Exemplo 1. Exemplo mysql_fetch_field()

<?php
$conn
= mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!
$conn) {
    die(
'Não foi possível conectar: ' . mysql_error());
}
mysql_select_db('database');
$result = mysql_query('select * from table');
if (!
$result) {
    die(
'A consulta falhou: ' . mysql_error());
}
/* obtém as informações da coluna */
$i = 0;
while (
$i < mysql_num_fields($result)) {
    echo
"Informação para a coluna $i:<br />\n";
    
$meta = mysql_fetch_field($result, $i);
    if (!
$meta) {
        echo
"Sem informação disponível<br />\n";
    }
    echo
"<pre>
blob:         $meta
->blob
max_length:   $meta
->max_length
multiple_key: $meta
->multiple_key
name:         $meta
->name
not_null:     $meta
->not_null
numeric:      $meta
->numeric
primary_key:  $meta
->primary_key
table:        $meta
->table
type:         $meta
->type
default:      $meta
->def
unique_key:   $meta
->unique_key
unsigned:     $meta
->unsigned
zerofill:     $meta
->zerofill
</pre>"
;
    
$i++;
}
mysql_free_result($result);
?>

Notas

Nota: Nomes de campos nesta função diferenciam maiúsculas e minusculas.

Veja também

mysql_field_seek()