mysqli_fetch_fields
(PHP 5)
mysqli_fetch_fields
(no version information, might be only in CVS)
result->fetch_fields -- Retorna uma matriz de objetos representando os campos em um conjunto de resultados
Descrição
Estilo de procedimento:
mixed
mysqli_fetch_fields ( object result )
Estilo orientado a objeto (metodo):
class
result {
mixed
fetch_fields ( void )
}
Esta função serve para o mesmo propósito que a função mysqli_fetch_field()
com uma simples diferença, ao invés de retornar um objeto de cada vez para
cada campo, as colunas são retornadas como uma matriz de objetos.
Valores de retorno
Retorna uma matriz de objetos o quais contém informações sobre as definições dos
campo ou FALSE se não houver inforções dos campos disponíveis.
Tabela 1. Propriedades dos objetos
Propriedade | Descrição |
---|
name | O nome da coluna |
orgname | O nome original da coluna se foi especificado um alias |
table | O nome da tabela a qual o campo pertence (se não for calculado) |
orgtable | Nome da tabela original se foi especificado um alias |
def | O valor padrão para este campo, representado como um string |
max_length | A largura máxima do campo no conjunto de resultados. |
flags | Um inteiro representando bit-flags para o campo. |
type | O tipo de dados usado para este campo |
decimals | O número de decimais usados (para campos integer) |
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 */ $finfo = $result->fetch_fields();
for ($i=0; $i < count($finfo); $i++) { printf("Name: %s\n", $finfo[$i]->name); printf("Table: %s\n", $finfo[$i]->table); printf("max. Len: %d\n", $finfo[$i]->max_length); printf("Flags: %d\n", $finfo[$i]->flags); printf("Type: %d\n\n", $finfo[$i]->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 columns */ $finfo = mysqli_fetch_fields($result); for ($i=0; $i < count($finfo); $i++) { printf("Name: %s\n", $finfo[$i]->name); printf("Table: %s\n", $finfo[$i]->table); printf("max. Len: %d\n", $finfo[$i]->max_length); printf("Flags: %d\n", $finfo[$i]->flags); printf("Type: %d\n\n", $finfo[$i]->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 |