PEAR Manual
Prev |  | Next

# MDB_Common::getRow()

MDB_Common::getRow() -- fetch the first row

## Synopsis

    require_once 'MDB.php';

``array &getRow` (string $query, array [$types = `NULL`], array [$params = array()], array [$param_types = `NULL`], integer [$fetchmode = `MDB_FETCHMODE_DEFAULT`])`

## Description

Fetch 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

array `$types`

  if supplied, the types of the columns 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

integer `$fetchmode`

  the fetch mode to use, default is `MDB_FETCHMODE_DEFAULT`

## Return value

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

## Throws

Table 33-1. Possible PEAR_Error values

Error code | Error message | Reason | Solution
--- | --- | --- | ---
`MDB_ERROR_INVALID` | `NULL` | SQL statment 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 statment. | Check the number of wild cards given in the SQL statment 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 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() , prepareQuery() executeQuery() , getCol() , getRow() , getAssoc()

Prev | Home | Next
MDB_Common::getOne() | Up | MDB_Common::getTextValue()