Returns the values of one or more fields and deletes them from a hash.
HGETDEL key
FIELDS numfields field
[field…]
The HGETDEL command returns the values associated with
the specified fields in the hash stored at key
and deletes those fields from the hash.
For every field that does not exist in the hash, a
nil value is returned. Because non-existing keys are
treated as empty hashes, running HGETDEL against a
non-existing key will return a list of nil
values.
When the last field is deleted, the key is also deleted.
Array reply: a list of
values associated with the given fields that are deleted or
nil for the fields that do not exist. These are in same
order as requested.
O(N) where N is the number of fields to be retrieved and deleted.
@fast @hash @write
127.0.0.1:6379> HSET myhash f1 v1 f2 v2 f3 v3
(integer) 3
127.0.0.1:6379> HGETDEL myhash FIELDS 1 f2
1) "v2"
127.0.0.1:6379> HGETDEL myhash FIELDS 1 f2
1) (nil)
127.0.0.1:6379> HGETALL myhash
1) "f1"
2) "v1"
3) "f3"
4) "v3"
127.0.0.1:6379> HGETDEL myhash FIELDS 2 f2 f3
1) (nil)
2) "v3"
127.0.0.1:6379> HGETALL myhash
1) "f1"
2) "v1"
127.0.0.1:6379> HGETDEL myhash FIELDS 3 f1 non-exist
(error) ERR syntax error
127.0.0.1:6379> HGETDEL myhash FIELDS 2 f1 non-exist
1) "v1"
2) (nil)
127.0.0.1:6379> HGETALL myhash
(empty array)HDEL, 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.