アイテムを新しいキーで追加する

# Memcached::add

(PECL memcached >= 0.1.0)

Memcached::add — アイテムを新しいキーで追加する

### 説明

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

Memcached::add() は Memcached::set() と似ていますが、 `key` が既にサーバー上に存在する場合は失敗します。

### パラメータ

`key`

  値の格納先のキー。

`value`

  格納する値。

`expiration`

  期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限 を参照ください。

### 返り値

成功した場合に `TRUE` を、失敗した場合に `FALSE` を返します。 キーが既に存在する場合は、Memcached::getResultCode() は `Memcached::RES_NOTSTORED` を返します。

### 参考

- Memcached::addByKey() - 指定したサーバーにアイテムを新しいキーで追加する
- Memcached::set() - アイテムを格納する
- Memcached::replace() - 既存のキーのアイテムを入れ替える