HDEL

Deletes one or more fields and their values from a hash. Deletes the hash if no fields remain.

Usage

HDEL key field [field…]

Description

Removes the specified fields from the hash stored at key. Specified fields that do not exist within this hash are ignored. If key does not exist, it is treated as an empty hash and this command returns 0.

Reply

Integer reply: the number of fields that were removed from the hash, excluding any specified but non-existing fields.

Complexity

O(N) where N is the number of fields to be removed.

ACL Categories

@fast @hash @write

Examples

127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
127.0.0.1:6379> HDEL myhash field1
(integer) 1
127.0.0.1:6379> HDEL myhash field2
(integer) 0

History

• 2.0.0: Introduced.
• 2.4.0: Accepts multiple field arguments.

See also

HEXISTS, HEXPIRE, HEXPIREAT, HEXPIRETIME, HGET, HGETALL, HGETEX, HINCRBY, HINCRBYFLOAT, HKEYS, HLEN, HMGET, HMSET, HPERSIST, HPEXPIRE, HPEXPIREAT, HPEXPIRETIME, HPTTL, HRANDFIELD, HSCAN, HSET, HSETEX, HSETNX, HSTRLEN, HTTL, HVALS.