MDB_Common::fetchCol()

MDB_Common::fetchCol() – Fetch a single column

Synopsis

require_once 'MDB.php';

array &fetchCol ( resource $result , mixed $colnum = 0 )

Description

Fetch a single column from a result set of a result set and free the result set.

Parameter

resource $result

a valid resource returned by query() or executeQuery()

array $params

if supplied, prepareQuery()/ executeQuery() will be used with this array as execute parameters

mixed $colnum

which column to return (integer [column number, starting at 0] or string [column name])

Return value

array - the first row of results as an array indexed from 0 or a MDB_Error, if fail

Throws

Possible PEAR_Error values
Error code Error message Reason Solution
MDB_ERROR_TRUNCATED NULL The result set contains fewer then two columns Check the SQL query or choose another query*() 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 statement. Ie. using LIMIT in a SQL-Statement for an Oracle database.

Note

This function can not be called statically.