maxdb_fetch_array
result->fetch_array
Fetch a result row as an associative, a numeric array, or both
Description
Procedural style:
mixedmaxdb_fetch_array
resourceresult
intresulttype
Object oriented style (method):
result
mixed
fetch_array
intresulttype
Returns an array that corresponds to the fetched row or &null; if there are no more rows for the
resultset represented by the result parameter.
maxdb_fetch_array is an extended version of the
maxdb_fetch_row function. In addition to storing the data in the
numeric indices of the result array, the maxdb_fetch_array function can
also store the data in associative indices, using the field names of the result set as keys.
&database.field-case;
&database.fetch-null;
If two or more columns of the result have the same field names, the last column will take
precedence and overwrite the earlier data. In order to access multiple columns with the same
name, the numerically indexed version of the row must be used.
The optional second argument resulttype is a constant indicating what
type of array should be produced from the current row data. The possible values for this parameter
are the constants MAXDB_ASSOC, MAXDB_ASSOC_UPPER, MAXDB_ASSOC_LOWER, MAXDB_NUM, or MAXDB_BOTH.
By default the
maxdb_fetch_array function will assume MAXDB_BOTH, which is a combination of
MAXDB_NUM and MAXDB_ASSOC for this parameter.
By using the MAXDB_ASSOC constant this function will behave identically to the
maxdb_fetch_assoc, while MAXDB_NUM will behave identically to the
maxdb_fetch_row function. The final option MAXDB_BOTH will create a single
array with the attributes of both.
By using the MAXDB_ASSOC_UPPER constant, the behaviour of this function is identical to the use
of MAXDB_ASSOC except the array index of a column is the fieldname in upper case.
By using the MAXDB_ASSOC_LOWER constant, the behaviour of this function is identical to the use
of MAXDB_ASSOC except the array index of a column is the fieldname in lower case.
Return values
Returns an array that corresponds to the fetched row or &null; if there are no more rows in resultset.
See also
maxdb_fetch_assoc,
maxdb_fetch_row,
maxdb_fetch_resource.
Example
Object oriented style
query($query);
/* numeric array */
$row = $result->fetch_array(MAXDB_NUM);
printf ("%s (%s)\n", $row[0], $row[1]);
/* associative array */
$row = $result->fetch_array(MAXDB_ASSOC);
printf ("%s (%s)\n", $row["NAME"], $row["STATE"]);
/* associative and numeric array */
$row = $result->fetch_array(MAXDB_BOTH);
printf ("%s (%s)\n", $row[0], $row["STATE"]);
/* free result set */
$result->close();
/* close connection */
$maxdb->close();
?>
]]>
Procedural style
]]>
The above examples would produce the following output: