What's new in Valkey 9.0? Discover new features and improvements. Read the announcement.

HDEL

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

Usage
HDEL key field ...
Complexity
O(N) where N is the number of fields to be removed.
Since
2.0.0
ACL Categories
@fast, @hash, @write
Command flags
WRITE, FAST

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.

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

Replies

RESP2

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

RESP3

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

History

  • 2.4.0: Accepts multiple `field` arguments.