# dbplus_add

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

dbplus_add — Add a tuple to a relation

### 说明

dbplus_add ( resource `$relation` , array `$tuple` ) : int

Adds a tuple to a `relation`.

### 参数

`relation`

`tuple`

  An array of attribute/value pairs to be inserted into the given `relation`.

  After successful execution this array will contain the complete data of the newly created tuple, including all implicitly set domain fields like sequences.

### 返回值

The function will return `DBPLUS_ERR_NOERR` on success or a db++ error code on failure.

### 注释

Warning

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

### 参见

- dbplus_errcode() - Get error string for given errorcode or last error