Fetch the entire result set of a query and return it as an
associative array using the first column as the key. The function takes
care of doing the query and freeing the results when finished.
If the result set contains more than two columns, the value
will be an array of the values from column 2 to n. If the result
set contains only two columns, the returned value will be a
scalar with the value of the second column (unless forced to an
array with the $force_array parameter).
Parameter
string
$query
the SQL query
boolean
$force_array
used only if the query returns
exactly two columns.
If TRUE, the values of the returned array
will be one-element arrays instead of scalars.
array
array $params
if supplied,
prepare()/
execute() will
be used with this array as
execute parameters
integer
$fetchmode
the fetch mode to use
boolean
boolean $group
if TRUE, the values of
the returned array is wrapped in another array.
If the same key value (in the first column)
repeats itself, the values
will be appended to this array instead
of overwriting the
existing values.
Return value
array - associative array with results from the
query.
To less data for filling the prepared SQL statment.
Check the number of wild cards given in the SQL statment
prepare(). Check the count of
entries in the array for $params. The count
of entries have to be equal to the number of wild cards.
Check the SQL query or choose another
get*() function
every other error code
Database specific error
Check the database related section of
PHP-Manual
to detect the reason for this error. In the most cases
a misformed SQL statment. Ie. using LIMIT in a SQL-Statment
for an Oracle database.
