GETEX
Syntax
GETEX key [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | PERSIST]
Time complexity: O(1)
Get the value of key
and optionally set its expiration.
GETEX
is similar to GET
, but is a write command with additional options.
Options
The GETEX
command supports a set of options that modify its behavior:
EX
seconds -- Set the specified expire time, in seconds.PX
milliseconds -- Set the specified expire time, in milliseconds.EXAT
timestamp-seconds -- Set the specified Unix time at which the key will expire, in seconds.PXAT
timestamp-milliseconds -- Set the specified Unix time at which the key will expire, in milliseconds.PERSIST
-- Remove the time to live associated with the key.
When supplied with no options, GETEX
is equivalent to GET
.
Return
Bulk string reply: the value of key
, or nil
when key
does not exist.
Examples
dragonfly> SET mykey "Hello"
"OK"
dragonfly> GETEX mykey
"Hello"
dragonfly> TTL mykey
(integer) -1
dragonfly> GETEX mykey EX 60
"Hello"
dragonfly> TTL mykey
(integer) 60