DB_Common::getCol()

DB_Common::getCol() -- Fetch a single column

Synopsis

require_once 'DB.php';

array &getCol (string $query [, mixed $col = 0 [, array $params = array()]])

Description

Fetch a single column from a result set

Parameter

string $query

the SQL query

mixed $col

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

array $params

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

Return value

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

Throws

Table 20-1. Possible PEAR_Error values

Error codeError messageReasonSolution
DB_ERROR_INVALID null SQL statment for preparing is not valid. See the prepare() documentation, if you want to use a SQL statemt using wildcards.
DB_ERROR_NEED_MORE_DATA null 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.
DB_ERROR_NO_DB_SELECTED null No database was choosen. Check the DSN in connect().
DB_ERROR_TRUNCATED null The result set contains fewer then two columns 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.

Note

This function can not be called statically

See

query() , limitQuery() , prepare() , execute() , getRow() , getOne() , getAssoc()