maxdb_fetch_field

(PECL)

maxdb_fetch_field

(no version information, might be only in CVS)

result->fetch_field -- Returns the next field in the result set

Description

Procedural style:

mixed maxdb_fetch_field ( resource result )

Object oriented style (method):

class result {

mixed fetch_field ( void )

}

The maxdb_fetch_field() returns the definition of one column of a result set as an resource. Call this function repeatedly to retrieve information about all columns in the result set. maxdb_fetch_field() returns FALSE when no more fields are left.

Return values

Returns an resource which contains field definition informations or FALSE if no field information is available.

表 1. Object properties

PropertyDescription
nameThe name of the column
max_lengthThe maximum width of the field for the result set.
typeThe data type used for this field
decimalsThe number of decimals used (for integer fields)

See also

maxdb_num_fields() maxdb_fetch_field_direct() maxdb_fetch_fields() maxdb_field_seek()

Example

例 1. Object oriented style

<?php
$maxdb
= new maxdb("localhost", "MONA", "RED", "DEMODB");

/* check connection */
if (maxdb_connect_errno()) {
   
printf("Connect failed: %s\n", maxdb_connect_error());
   exit();
}

$query = "SELECT name, cno from hotel.customer ORDER BY cno";

if (
$result = $maxdb->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 */
$maxdb->close();
?>

例 2. Procedural style

<?php
$link
= maxdb_connect("localhost", "MONA", "RED", "DEMODB");

/* check connection */
if (maxdb_connect_errno()) {
   
printf("Connect failed: %s\n", maxdb_connect_error());
   exit();
}

$query = "SELECT name, cno from hotel.customer ORDER BY cno";

if (
$result = maxdb_query($link, $query)) {

   
/* Get field information for all fields */
   
while ($finfo = maxdb_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);
   }
   
maxdb_free_result($result);
}

/* close connection */
maxdb_close($link);
?>

The above examples would produce the following output:

Name:     NAME
Table:
max. Len: 10
Flags:    -1
Type:     2

Name:     CNO
Table:
max. Len: 4
Flags:    -1
Type:     0