mysqli_fetch_field
Manual de PHP
AnteriorSiguiente

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
AnteriorInicioSiguiente
mysqli_fetch_field_directSubirmysqli_fetch_fields