mysqli_fetch_field

(PHP 5)

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 ( 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 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)

Ver también

mysqli_num_fields(), mysqli_fetch_field_direct(), mysqli_fetch_fields(), y 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);
?>

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

Hosting by: hurra.com
Generated: 2007-01-26 18:00:47