PEAR Manual
Prev |  | Next

# MDB_Common::fetchCol()

MDB_Common::fetchCol() -- Fetch a single column

## Synopsis

    require_once 'MDB.php';

``array &fetchCol` (resource $result, mixed [$colnum = 0])`

## Description

Fetch a single column from a result set of a result set and free the result set.

## Parameter

resource `$result`

  a valid resource returned by query() or executeQuery()

array `$params`

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

mixed `$colnum`

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

## 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_TRUNCATED` | `NULL` | The result set contains fewer then two columns | Check the SQL query or choose another query*() 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() , prepareQuery() , executeQuery() , fetchRow() , fetchOne() , fetchAll()

Prev | Home | Next
MDB_Common::fetchAll() | Up | MDB_Common::fetchOne()