DB_Common::getOne()

DB_Common::getOne() -- fetch the first column of the first row

Synopsis

require_once 'DB.php';

mixed &getOne (string $query [, array $params = array])

Description

Fetch the first column of the first row of data returned from a query. The function takes care of doing the query and freeing the results when finished.

Parameter

string $query

the SQL query or the statement to prepare

array $params

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

Return value

mixed - the returned value 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().
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() , getCol() , getCol() , getCol()