Skip to main content

GETEX

Syntax

GETEX key [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | PERSIST]

Time complexity: O(1)

ACL categories: @write, @string, @fast

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