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
操作传播,因此底层浮点数学实现的差异不会成为不一致的来源。