Manual do PHP
Anterior |  | Próxima

# 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

Atibuto | Descrição
--- | ---
name | O nome da coluna
orgname | Nome original da coluna se foi especificado um alias
table | O nome da tabela a qual este campo pertence (se não for calculada)
orgtable | Nome da tabela original se foi especificado um alias
def | O valor padrão para este campo, representado por uma string
max_length | O limite de tamanho para o campo no conjunto de resultados.
flags | Um inteiro representando bit-flags para o campo.
type | O tipo de dados para este campo
decimals | O 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

Anterior | Principal | Próxima
mysqli_fetch_assoc | Acima | mysqli_fetch_field