# dbplus_first

(PHP 4 <= 4.1.0, PECL dbplus >= 0.9)

dbplus_first — Get first tuple from relation

### 说明

dbplus_first ( resource `$relation` , array `&$tuple` ) : int

Reads the data for the first tuple for the given `relation`, makes it the current tuple and pass it back as an associative array in `tuple`.

### 参数

`relation`

  A relation opened by dbplus_open().

`tuple`

### 返回值

Returns `DBPLUS_ERR_NOERR` on success or a db++ error code on failure.

### 注释

Warning

此函数是实验性的。此函数的表象，包括名称及其相关文档都可能在未来的 PHP 发布版本中未通知就被修改。使用本函数风险自担 。

### 参见

- dbplus_curr() - Get current tuple from relation
- dbplus_prev() - Get previous tuple from relation
- dbplus_next() - Get next tuple from relation
- dbplus_last() - Get last tuple from relation
- dbplus_errcode() - Get error string for given errorcode or last error