HDEL

Synopsis

HDEL key field [field ...]

This command removes the given fields from the hash that is associated with the given key.

• If the given key does not exist, it is characterized as an empty hash, and 0 is returned for no elements are removed.
• If the given key is associated with non-hash data, an error is raised.

Return value

Depends on the configuration parameter emulate_redis_responses.

• If emulate_redis_responses is true, returns the number of existing fields in the hash that were removed by this command.
• If emulate_redis_responses is false, returns OK.

Examples

• emulate_redis_responses is true.

  shCopy

  $ HSET yugahash moon "Moon"
  

  Copy

  1
  

  shCopy

  $ HDEL yugahash moon
  

  Copy

  1
  

  shCopy

  $ HDEL yugahash moon
  

  Copy

  0
  

• emulate_redis_responses is false.

  shCopy

  $ HSET yugahash moon "Moon"
  

  Copy

  "OK"
  

  shCopy

  $ HDEL yugahash moon
  

  Copy

  "OK"
  

  shCopy

  $ HDEL yugahash moon
  

  Copy

  "OK"
  

See also

hexists, hget, hgetall, hkeys, hlen, hmget, hmset, hset, hincrby, hstrlen, hvals