mysqli_fetch_field
result->fetch_field
Returns the next field in the result set
Description
Procedural style:
mixedmysqli_fetch_field
objectresult
Object oriented style (method):
result
mixed
fetch_field
void
The mysqli_fetch_field function is used to return the attributes
of the next column in the result set represented by the result
parameter as an object. When executed this function will return an object containing
the attributes of the current column or &false; if there are no more columns in the
result set.
Return values
Returns an object which contains field definition informations or &false; if no field information
is available.
Object attributes
Attribute
Description
name
The name of the column
orgname
Original column name if an alias was specified
table
The name of the table this field belongs to (if not calculated)
orgtable
Original table name if an alias was specified
def
The default value for this field, represented as a string
max_length
The maximum width of the field for the result set.
flags
An integer representing the bit-flags for the field.
type
The data type used for this field
decimals
The number of decimals used (for integer fields)
See also
mysqli_num_fields
mysqli_fetch_field_direct
mysqli_fetch_fields
mysqli_field_seek
Example
Object oriented style
query( "DROP TABLE IF EXISTS friends");
$mysqli->query( "CREATE TABLE friends (id int, name varchar(20))");
$mysqli->query( "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')");
$result = $mysqli->query( "SELECT id, name FROM friends");
/* Get field information for all columns */
while ($finfo = $result->fetch_field()) {
printf("Name: %s\n", $finfo->name);
printf("Table: %s\n", $finfo->table);
printf("Default: %s\n", $finfo->def);
printf("max. Len: %d\n", $finfo->max_length);
printf("Flags: %d\n", $finfo->flags);
printf("Type: %d\n", $finfo->type);
}
$result->close();
$mysqli->close();
?>
]]>
Procedural style
name);
printf("Table: %s\n", $finfo->table);
printf("Default: %s\n", $finfo->def);
printf("max. Len: %d\n", $finfo->max_length);
printf("Flags: %d\n", $finfo->flags);
printf("Type: %d\n", $finfo->type);
}
mysqli_free_result($result);
mysqli_close($link);
?>
]]>