mysqli_result::fetch_field

mysqli_fetch_field

(PHP 5, PHP 7, PHP 8)

mysqli_result::fetch_field -- mysqli_fetch_fieldRetorna o próximo campo no conjunto de resultados

Descrição

Estilo orientado a objetos

public mysqli_result::fetch_field(): object|false

Estilo procedural

mysqli_fetch_field(mysqli_result $result): object|false

Retorna a definição de uma coluna de um conjunto de resultados como um objeto. Utilize esta função repetidamente para obter informação sobre todas as colunas no conjunto de resultados.

Parâmetros

result

Somente no estilo procedural: Um objeto mysqli_result retornado por mysqli_query(), mysqli_store_result(), mysqli_use_result() ou mysqli_stmt_get_result().

Valor Retornado

Retorna um objeto que contém informações sobre a definição do campo ou false se nenhuma informação de campos estiver disponível.

Propriedades do objeto
Propriedade Descrição
name O nome da coluna
orgname Nome original da coluna se foi especificado um apelido
table O nome da tabela à qual este campo pertence (se não calculada)
orgtable Nome da tabela original se foi especificado um apelido
def Reservado para o valor padrão, atualmente sempre igual a ""
db O nome do banco de dados
catalog O nome do catálogo, sempre igual a "def"
max_length O tamanho máximo do campo para o conjunto de resultados.
length A largura do campo, como especificada na definição da tabela.
charsetnr O número do conjunto de caracteres para o campo.
flags Um inteiro representando os bits de opções para o campo.
type O tipo de dados usado para este campo
decimals O número de decimais usadas (para campos inteiros)

Exemplos

Exemplo #1 Estilo orientado a objetos

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

/* verifica a conexão */
if (mysqli_connect_errno()) {
printf("Conexão falhou: %s\n", mysqli_connect_error());
exit();
}

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

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

/* Obtém informação do campo para todos os campos */
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();
}

/* fecha a conexão */
$mysqli->close();
?>

Exemplo #2 Estilo procedural

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

/* verifica a conexão */
if (mysqli_connect_errno()) {
printf("Conexão falhou: %s\n", mysqli_connect_error());
exit();
}

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

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

/* Obtém informação do campo para todos os campos */
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);
}

/* fecha a conexão */
mysqli_close($link);
?>

Os exemplos acima produzirão:

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

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

Veja Também