(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.
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
<?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();
?>
<?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