summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/setex.md
blob: 6181b73e92904287ae84425b705ba305515a9b8f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
Set `key` to hold the string `value` and set `key` to timeout after a given
number of seconds. This command is equivalent to executing the following
commands:

```
SET mykey value
EXPIRE mykey seconds
```

`SETEX` is atomic, and can be reproduced by using the previous two commands
inside an `MULTI` / `EXEC` block. It is provided as a faster alternative to the
given sequence of operations, because this operation is very common when Redis
is used as a cache.

An error is returned when `seconds` is invalid.

@return

@simple-string-reply

@examples

```cli
SETEX mykey 10 "Hello"
TTL mykey
GET mykey
```