mysqli_fetch_field

(PHP 5)

mysqli_fetch_field

(no version information, might be only in CVS)

result->fetch_field -- Retorna o próximo campo no conjunto de resultados

Descrição

Estilo de procedimento:

mixed mysqli_fetch_field ( object result )

Estilo orientado a objeto (metodo):

class result {

mixed fetch_field ( void )

}

A função mysqli_fetch_field() retorna a definição de uma coluna do conjunto de resultados como um objeto. Utilize esta função repetidamente para obter sobre todas as colunas no conjunto de resultados. mysqli_fetch_field() retorna FALSE quando não houverem mais campos.

Valores de retorno

Retorna um objeto o qual contém informações sobre a definição do campoou FALSE se não houver informação sobre campos disponível.

Tabela 1. Propriedades do objeto

PropriedadeDescrição
nameO nome da coluna
orgnameNome original da coluna se foi especificado um alias
tableO nome da tabela a qual este campo pertence (se não for calculada)
orgtableNome da tabela original se foi especificado um alias
defO valor padrão para este campo, representando como uma string
max_lengthO tamanho máximo do campo no conjunto de resultados.
flagsUm inteiro representando bit-flags para o campo.
typeO tipo de dados usado para este campo
decimalsO número de decimais usados (par campos integer)

Veja também

mysqli_num_fields(), mysqli_fetch_field_direct(), mysqli_fetch_fields(), mysqli_field_seek().

Exemplo

Exemplo 1. Estilo orientado a objeto

<?php
$mysqli
= new mysqli("localhost", "my_user", "my_password", "world");

/* check connection */
if (mysqli_connect_errno()) {
    
printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

$query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

if (
$result = $mysqli->query($query)) {

    
/* Get field information for all columns */
    
while ($finfo = $result->fetch_field()) {

        
printf("Name:     %s\n", $finfo->name);
        
printf("Table:    %s\n", $finfo->table);
        
printf("max. Len: %d\n", $finfo->max_length);
        
printf("Flags:    %d\n", $finfo->flags);
        
printf("Type:     %d\n\n", $finfo->type);
    }    
    
$result->close();
}

/* close connection */
$mysqli->close();
?>

Exemplo 2. Estilo de procedimento

<?php
$link
= mysqli_connect("localhost", "my_user", "my_password", "world");

/* check connection */
if (mysqli_connect_errno()) {
    
printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

$query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

if (
$result = mysqli_query($link, $query)) {

    
/* Get field information for all fields */
    
while ($finfo = mysqli_fetch_field($result)) {

        
printf("Name:     %s\n", $finfo->name);
        
printf("Table:    %s\n", $finfo->table);
        
printf("max. Len: %d\n", $finfo->max_length);
        
printf("Flags:    %d\n", $finfo->flags);
        
printf("Type:     %d\n\n", $finfo->type);
    }
    
mysqli_free_result($result);
}

/* close connection */
mysqli_close($link);
?>

Os exemplos acima devem produzir a seguinte saída:

Name:     Name
Table:    Country
max. Len: 11
Flags:    1
Type:     254

Name:     SurfaceArea
Table:    Country
max. Len: 10
Flags:    32769
Type:     4