mysqli_fetch_field_direct

(PHP 5)

mysqli_fetch_field_direct

(no version information, might be only in CVS)

result->fetch_field_direct --  Obtem meta dados para um único campo

Descrição

Estilo de procedimento:

mixed mysqli_fetch_field_direct ( object result, int fieldnr )

Estilo orientado a objeto (metodo):

class result {

mixed fetch_field_direct ( int fieldnr )

}

mysqli_fetch_field_direct() retorna um objeto o qual contém informações da definição de um campo do conjunto de resultados especificado. O valor de fieldnr deve estar no intervalo entre 0 e número de campos - 1.

Valores de retorno

Retorna um objeto o qual contém informações das definições de um campo ou FALSE se não houver informações sobre o campo especificado com fieldnr disponíveis.

Tabela 1. Atributos do objeto

AtibutoDescriçã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, representado por uma string
max_lengthO limite de tamanho para o campo no conjunto de resultados.
flagsUm inteiro representando bit-flags para o campo.
typeO tipo de dados para este campo
decimalsO número de casas decimais usadas (para campos integer)

Veja também

mysqli_num_fields() mysqli_fetch_field() mysqli_fetch_fields()

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 Name LIMIT 5";

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

    
/* Get field information for column 'SurfaceArea' */
    
$finfo = $result->fetch_field_direct(1);

    
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", $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 Name LIMIT 5";

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

    
/* Get field information for column 'SurfaceArea' */
    
$finfo = mysqli_fetch_field_direct($result, 1);

    
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", $finfo->type);

    
mysqli_free_result($result);
}

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

Os exemplos acima devem produzir a seguinte saída:

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