GETSET

GETSET key value

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

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

可用版本:

>= 1.0.0

时间复杂度:

O(1)

返回值:

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

  1. redis> GETSET db mongodb # 没有旧值,返回 nil
  2. (nil)
  3. redis> GET db
  4. "mongodb"
  5. redis> GETSET db redis # 返回旧值 mongodb
  6. "mongodb"
  7. redis> GET db
  8. "redis"

模式

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

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

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

  1. redis> INCR mycount
  2. (integer) 11
  3. redis> GETSET mycount 0 # 一个原子内完成 GET mycount 和 SET mycount 0 操作
  4. "11"
  5. redis> GET mycount # 计数器被重置
  6. "0"