mysqli fetch field

(PHP 5)

mysqli_fetch_field, result->fetch_field — Regresa metadatos de el campo en el resultado

Descripción

Estilo por procedimientos:

mixto mysqli_fetch_field ( mysqlI_result $resultado )

Estilo orientado a objetos (método):

class mysqli_result {
mixto fetch_field ( void )
}

La función mysqli_fetch_field() regresa un objeto con información de definición de un campo de un resultado. Ejecute esta función repetidamente para obtener la información de todas las columnas en un resultado. mysqli_fetch_field() regresa FALSE cuando no hay más columnas en el resultado.

Valores retornados

Regresa un objeto el cual contiene la información de la definición del campo o FALSE si no hay información disponible.

Tabla 176. Propiedades del objeto

Propiedad Descripción
name El nombre de la columna
orgname Nombre original de la columna, si se específico un alias
table El nombre de la tablaa la cuál pertenece
orgtable Nombre original de la tabla si se específico un alias
def El valor por defecto de este campo, representado con una cadena
max_length La máma amplitud del campo para el resultado
flags Un entero representando los bit de bandera para el campo
type El tipo de dato usado para este campo
decimals El número de decimales utilizadas (para campos numéricos)

Ver también

mysqli_num_fields(), mysqli_fetch_field_direct(), mysqli_fetch_fields(), y mysqli_field_seek()

Ejemplos

Estilo orientado a objetos

<?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 */
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();
}

/* close connection */
$mysqli->close();
?>

Estilo por procedimientos

<?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 fields */
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);
}

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

El resultado del ejemplo seria:

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

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