mysqli_fetch_field

(PHP 5 CVS only)

mysqli_fetch_field

(no version information, might be only in CVS)

result->fetch_field -- Regresa metadatos de el campo en el resultado

Descripción

Estilo por procedimientos:

mixto mysqli_fetch_field ( objeto resultado)

Estilo orientado a objetos (método):

class resultado {

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 regresados

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

Tabla 1. Propiedades del objeto

PropiedadDescripción
nameEl nombre de la columna
orgnameNombre original de la columna, si se específico un alias
tableEl nombre de la tablaa la cuál pertenece
orgtableNombre original de la tabla si se específico un alias
defEl valor por defecto de este campo, representado con una cadena
max_lengthLa máma amplitud del campo para el resultado
flagsUn entero representando los bit de bandera para el campo
typeEl tipo de dato usado para este campo
decimalsEl número de decimales utilizadas (para campos numéricos)

Vea también

mysqli_num_fields() mysqli_fetch_field_direct() mysqli_fetch_fields() mysqli_field_seek()

Ejemplos

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

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

Los ejemplos anteriores producirán la siguiente salida:

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

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