hdel.3valkey - Man Page
Deletes one or more fields and their values from a hash. Deletes the hash if no fields remain.
Synopsis
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
Resp2
valkey-protocol(7) Integer reply: the number of fields that were removed from the hash, excluding any specified but non-existing fields.
Resp3
valkey-protocol(7) 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
History
- Available since: 2.0.0
- Changed in 2.4.0: Accepts multiple
fieldarguments.
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
See Also
hexists(3valkey), hget(3valkey), hgetall(3valkey), hincrby(3valkey), hincrbyfloat(3valkey), hkeys(3valkey), hlen(3valkey), hmget(3valkey), hrandfield(3valkey), hscan(3valkey), hset(3valkey), hsetnx(3valkey), hstrlen(3valkey), hvals(3valkey)