JavaScript Editor Javascript validator     Web page editor 


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


require_once 'MDB.php';

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


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.


string $query

the SQL query or the statement to prepare

string $type

if supplied, the type of the column in the result set will be set for fetching

array $params

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

array $param_types

if supplied, the values in $param will automatically set to the passed datatypes

Return value

mixed - the returned value or a MDB_Error, if fail


Table 39-1. Possible PEAR_Error values

Error codeError messageReasonSolution
MDB_ERROR_INVALID NULL SQL statement for preparing is not valid. See the prepareQuery() documentation, if you want to use a SQL statemt using wildcards.
MDB_ERROR_NEED_MORE_DATA NULL To less data for filling the prepared SQL statement. Check the number of wild cards given in the SQL statement prepareQuery() . Check the count of entries in the array for $params. The count of entries have to be equal to the number of wild cards.
MDB_ERROR_NO_DB_SELECTED NULL No database was chosen. 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 statement. Ie. using LIMIT in a SQL-Statement for an Oracle database.


This function can not be called statically.


query() , limitQuery() , prepareQuery() , executeQuery() , getRow() , getCol() , getCol() , getCol()

JavaScript Editor Javascript validator     Web page editor