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.

    $ HSET yugahash moon "Moon"
    
    1
    
    $ HDEL yugahash moon
    
    1
    
    $ HDEL yugahash moon
    
    0
    
  • emulate_redis_responses is false.

    $ HSET yugahash moon "Moon"
    
    "OK"
    
    $ HDEL yugahash moon
    
    "OK"
    
    $ HDEL yugahash moon
    
    "OK"
    

See also

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