# Memcached::add

(PECL memcached >= 0.1.0)

Memcached::add — 向新 key 添加元素

### 说明

public Memcached::add(string `$key`, mixed `$value`, int `$expiration` = 0): bool

Memcached::add() 与 Memcached::set() 类似，但如果 `key` 已经在服务端存在，则操作失败。

### 参数

`key`

  用于存储值的键名。

`value`

  存储的值。

`expiration`

  到期时间，默认为 0。 更多信息请参见到期时间。

### 返回值

成功时返回 `true`， 或者在失败时返回 `false`。 如果 key 已经存在，Memcached::getResultCode() 将会返回 `Memcached::RES_NOTSTORED`。

### 参见

- Memcached::addByKey() - 在特定服务器上向新 key 添加元素
- Memcached::set() - 存储一个元素
- Memcached::replace() - 替换已存在 key 下的元素

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open