Memcached add 命令用于将 value(数据值) 存储在指定的 key(键) 中。

如果 add 的 key 已经存在，则不会更新数据，之前的值将仍然保持相同，并且您将获得响应 NOT_STORED。

语法：

add 命令的基本语法格式如下：

add key flags exptime bytes [noreply]
value

参数说明如下：

  • key：键值 key-value 结构中的 key，用于查找缓存值。

  • flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。

  • exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）

  • bytes：在缓存中存储的字节数

  • noreply（可选）： 该参数告知服务器不需要返回数据

  • value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）

实例

以下实例中我们设置：

  • key → new_key

  • flag → 0

  • exptime → 900 (以秒为单位)

  • bytes → 10 (数据存储的字节数)

  • value → data_value

add new_key 0 900 10
data_value
STORED
get new_key
VALUE new_key 0 10
data_value
END

输出

如果数据添加成功，则输出：

STORED

输出信息说明：

  • STORED：保存成功后输出。

  • NOT_STORED ：在保持失败后输出。