Fetch the first row of data returned from a query. The function takes care of doing the query and freeing the results when finished.
the SQL query
if supplied, prepare()/ execute() will be used with this array as execute parameters
the fetch mode to use, default is DB_FETCHMODE_DEFAULT
Table 20-1. Possible PEAR_Error values
| Error code | Error message | Reason | Solution |
|---|---|---|---|
| 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. |