*Redis INCRBYFLOAT 命令 将 key 的浮点数值加上指定数量

*语法

INCRBYFLOAT key increment

*说明

INCRBYFLOATkey 中储存的浮点数值(以 String 形式存储)加上增量 increment

  • 如果 key 不存在,先将其设为 0,再执行加法。
  • key 的值和 increment 均可使用指数符号(如 2.0e790e-2)。
  • 结果总是以十进制小数形式返回:小数尾随的 0 会被移除;整数形式的小数(如 3.0)会保存为整数 3
  • 计算结果最多保留小数点后 17 位有效精度。
  • 如果 key 当前值或 increment 无法解析为双精度浮点数,返回错误。

*返回值

Bulk string reply:加法后的新值(字符串形式)。

*时间复杂度

O(1)

*版本兼容性

Redis 版本 说明
>= 2.6.0 INCRBYFLOAT 可用

*示例

# 基础浮点增量
SET mykey 10.50
INCRBYFLOAT mykey 0.1

# 传入负值
INCRBYFLOAT mykey -5

# 使用指数符号
SET mykey 5.0e3
INCRBYFLOAT mykey 2.0e2

# 精度处理
SET pi 3.141592653589793
INCRBYFLOAT pi 0.000000000000001

# 查看结果
GET mykey