Memcached add Command

The Memcached add command is used to store a value in the specified key.

If the key being added already exists, the data will not be updated (expired keys will be updated), and the previous value will remain unchanged, with a response of NOT_STORED.

Syntax:

The basic syntax for the add command is as follows:

add key flags exptime bytes [noreply]
value

Parameter descriptions are as follows:

• key: The key in the key-value structure used to look up the cached value.
• flags: An integer parameter that can include key-value pairs, used by the client to store additional information about the key-value pair.
• exptime: The duration to keep the key-value pair in the cache (in seconds, 0 means forever).
• bytes: The number of bytes stored in the cache.
• noreply (optional): This parameter informs the server that no response is needed.
• value: The value to be stored (always on the second line) (can be directly understood as the value in the key-value structure).

Example

In the following example, we set:

• key → new_key
• flag → 0
• exptime → 900 (in seconds)
• bytes → 10 (number of bytes for data storage)
• value → data_value

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

Output

If the data is added successfully, the output will be:

STORED

Output information descriptions are as follows:

• STORED: Output after successful save.
• NOT_STORED: Output after failed save.