INCRBYFLOAT

Syntax
INCRBYFLOAT key increment
Available since:
2.6.0
Time complexity:
O(1)
ACL categories:
@write, @string, @fast,

将存储在key中的表示浮点数的字符串增加指定的increment。通过使用负的increment值,结果是存储在键中的值被减少(根据加法的明显属性)。 如果键不存在,则在执行操作之前将其设置为0。 如果发生以下任一情况,将返回错误:

  • 键包含的值类型错误(不是字符串)。
  • 当前键内容或指定的增量无法解析为双精度浮点数。

如果命令成功,新的递增值将作为键的新值存储(替换旧值),并以字符串形式返回给调用者。

字符串键中已经包含的值和增量参数可以选择以指数表示法提供,但是增量后计算的值始终以相同的格式存储,即一个整数,后面(如果需要)跟一个点,以及表示数字小数部分的可变位数。尾随零总是被移除。

输出的精度固定在小数点后17位,无论计算的实际内部精度如何。

示例

SET mykey 10.50 INCRBYFLOAT mykey 0.1 INCRBYFLOAT mykey -5 SET mykey 5.0e3 INCRBYFLOAT mykey 2.0e2

实现细节

该命令始终在复制链路和仅追加文件中作为SET操作传播,因此底层浮点数学实现的差异不会成为不一致的来源。

RESP2/RESP3 回复

Bulk string reply: the value of the key after the increment.
RATE THIS PAGE
Back to top ↑