(PHP 5, PHP 7, PHP 8)
mysqli_result::fetch_field -- mysqli_fetch_field — Retorna o próximo campo no conjunto de resultados
Estilo orientado a objetos
Estilo procedural
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.
result
Somente no estilo procedural: Um objeto mysqli_result retornado por mysqli_query(), mysqli_store_result(), mysqli_use_result() ou mysqli_stmt_get_result().
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.
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) |
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