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, returnsthe 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.
  1. $ HSET yugahash moon "Moon"
  1. 1
  1. $ HDEL yugahash moon
  1. 1
  1. $ HDEL yugahash moon
  1. 0
  • emulate_redis_responses is false.
  1. $ HSET yugahash moon "Moon"
  1. "OK"
  1. $ HDEL yugahash moon
  1. "OK"
  1. $ HDEL yugahash moon
  1. "OK"

See also

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