Forum und email
MySQL
PHP Manual

mysql_fetch_field

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

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.

Valor Retornado

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

  • name - nome da coluna
  • table - a tabela a qual o objeto pertence
  • def - o valor padrão da coluna
  • max_length - o limite de tamanho da coluna
  • not_null - 1 se a coluna não puder ser NULL
  • primary_key - 1 se a coluna é a chave primária
  • unique_key - 1 se a coluna é a chave única
  • multiple_key - 1 se a coluna é uma chave não-única
  • numeric - 1 se a coluna é numérica
  • blob - 1 se a coluna é um BLOB
  • type - o tipo da coluna
  • unsigned - 1 se a coluna é sem sinal
  • zerofill - 1 se a coluna é prenchida com zero

Exemplos

Example#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
PHP Manual