Redis 基础教程

Redis 命令

Redis 高级教程

Redis 笔记

original icon
版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.knowledgedict.com/tutorial/redis-command-hincrbyfloat.html

Redis HINCRBYFLOAT 命令

Redis 哈希(Hashes)底层数据结构及所有相关命令 Redis 哈希(Hashes)底层数据结构及所有相关命令


Redis HINCRBYFLOAT 命令为哈希表 key 中的域 field 的值加上浮点数增量 increment。增量也可以为负浮点数,相当于对指定域进行减法操作。

如果哈希表中没有域 field,那么 HINCRBYFLOAT 会先将域 field 的值设为 0,然后再执行加法操作。如果键 key 不存在,那么 HINCRBYFLOAT 会先创建一个哈希表,再创建域 field,最后再执行加法操作。

命令格式

HINCRBYFLOAT key field increment

可用版本:>=2.6.0

时间复杂度:O(1)

HINCRBYFLOAT 命令的详细功能和 INCRBYFLOAT 命令类似。

命令返回值

HINCRBYFLOAT 命令返回有 3 种情况:

  • 指定 key 不存在时,返回指定的增量。
  • 指定 key 存在且指定 field 为浮点数时,返回增量(可以为负数)之后的值。
  • 指定的 field 值为非浮点数时,返回一个错误。

示例

redis> HINCRBYFLOAT noexist field 188    # 指定 key 不存在时
"188"
redis> HSET myhash field1 1.88
(integer) 1
redis> HINCRBYFLOAT myhash field1 0.18   # 指定 key 存在且指定 field 为数字时
"2.06"
redis> HINCRBYFLOAT myhash field1 -0.06  # 增量为负数,相当于相减
"2"
redis> HSET myhash field2 suzuki
(integer) 1
redis> HINCRBYFLOAT myhash field2 1      # 指定的 field 值为非浮点数时,返回一个错误
(error) ERR hash value is not a valid float
redis>
Redis OBJECT 命令允许从内部查看指定 key 的 Redis 对象信息。它通常用在调试,或者了解相关 key 是否使用特殊编码的 ...
SORT命令返回或保存指定列表、集合、有序集合key中经过排序的元素。 ...
Redis GET 命令返回指定 key 所关联的字符串值。如果指定的 key 不存在时,返回特殊值 nil。此外,如果指定的 key 存储 ...
TYPE 命令返回指定 key 所储存的值的类型。 ...
Redis COMMAND 命令用于返回所有的 Redis 命令的详细信息,并以数组形式展示。 ...