INCRBYFLOAT

语法
INCRBYFLOAT key increment
可用版本
2.6.0
时间复杂度
O(1)
ACL 分类
@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

实现细节

该命令始终在复制链接和 Append Only File 中传播为 SET 操作,因此底层浮点数学实现中的差异不会成为不一致的来源。

RESP2/RESP3 响应

批量字符串回复: 增加后的键值。
RATE THIS PAGE
Back to top ↑