1. GETSET key value

将给定 key 的值设为 value ，并返回 key 的旧值(old value)。

当 key 存在但不是字符串类型时，返回一个错误。

1.1. 起始版本：

1.0.0

1.2. 时间复杂度：

O(1)

1.3. 返回值

返回给定 key 的旧值。当 key 没有旧值时，也即是， key 不存在时，返回 nil 。

1.4. 案例


127.0.0.1:6379> EXISTS key1
(integer) 0
127.0.0.1:6379> GETSET key1 value1 # 不存在的 key 执行 GETSET 操作，返回 nil
(nil)
127.0.0.1:6379> get key1
"value1"
127.0.0.1:6379> getset key1 new-value1 # 已存在的 key 执行 GETSET 操作， 返回旧value值
"value1"
127.0.0.1:6379> get key1
"new-value1"

1.5. 模式

GETSET 可以和 INCR 组合使用，实现一个有原子性(atomic)复位操作的计数器(counter)。

举例来说，每次当某个事件发生时，进程可能对一个名为 mycount 的 key 调用 INCR 操作，通常我们还要在一个原子时间内同时完成获得计数器的值和将计数器值复位为 0 两个操作。

可以用命令 GETSET mycounter 0 来实现这一目标。

redis> INCR mycount
(integer) 11

redis> GETSET mycount 0  # 一个原子内完成 GET mycount 和 SET mycount 0 操作
"11"

redis> GET mycount       # 计数器被重置
"0"

GETSET