Redis五大数据类型之Hash操作命令-CFANZ编程社区

Redis五大数据类型之Hash操作命令

一、常用命令

1.1 HSET hash field value
1.2 HSETNX hash field value
1.3 HGET hash field
1.4 HEXISTS hash field
1.5 HDEL key field [field …]
1.6 HLEN key
1.7 HSTRLEN key field
1.8 HINCRBY key field increment
1.9 HINCRBYFLOAT key field increment
1.10 HMSET key field value [field value …]
1.11 HMGET key field [field …]
1.12 HKEYS key
1.13 HVALS key
1.14 HGETALL key
1.15 HSCAN key cursor [MATCH pattern] [COUNT count]

二、实操

一、常用命令

1.1 HSET hash field value

将哈希表 hash 中域 field 的值设置为 value 。
如果给定的哈希表并不存在，那么一个新的哈希表将被创建并执行 HSET 操作。
如果域 field 已经存在于哈希表中，那么它的旧值将被新值 value 覆盖。
返回值：当 HSET 命令在哈希表中新创建 field 域并成功为它设置值时，命令返回 1 ；如果域 field 已经存在于哈希表，并且 HSET 命令成功使用新值覆盖了它的旧值，那么命令返回 0 。

1.2 HSETNX hash field value

当且仅当域 field 尚未存在于哈希表的情况下，将它的值设置为 value 。
如果给定域已经存在于哈希表当中，那么命令将放弃执行设置操作。
如果哈希表 hash 不存在，那么一个新的哈希表将被创建并执行 HSETNX 命令。
返回值：HSETNX 命令在设置成功时返回 1 ，在给定域已经存在而放弃执行设置操作时返回 0 。

1.3 HGET hash field

返回哈希表中给定域的值。
如果给定域不存在于哈希表中，又或者给定的哈希表并不存在，那么命令返回 nil 。

1.4 HEXISTS hash field

检查给定域 field 是否存在于哈希表 hash 当中。
返回值：HEXISTS 命令在给定域存在时返回 1 ，在给定域不存在时返回 0 。

1.5 HDEL key field [field …]

删除哈希表 key 中的一个或多个指定域，不存在的域将被忽略。
返回值：被成功移除的域的数量，不包括被忽略的域

1.6 HLEN key

返回哈希表 key 中域的数量。
返回值：哈希表中域的数量。当 key 不存在时，返回 0 。

1.7 HSTRLEN key field

返回哈希表 key 中，与给定域 field 相关联的值的字符串长度（string length）。
如果给定的键或者域不存在，那么命令返回 0 。
返回值：一个整数

1.8 HINCRBY key field increment

为哈希表 key 中的域 field 的值加上增量 increment 。

增量也可以为负数，相当于对给定域进行减法操作。如果 key 不存在，一个新的哈希表被创建并执行 HINCRBY 命令。如果域 field
不存在，那么在执行命令前，域的值被初始化为 0 。对一个储存字符串值的域 field 执行 HINCRBY 命令将造成一个错误。
本操作的值被限制在 64 位(bit)有符号数字表示之内。

1.9 HINCRBYFLOAT key field increment

为哈希表 key 中的域 field 加上浮点数增量 increment 。

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

当以下任意一个条件发生时，返回一个错误：

域 field 的值不是字符串类型(因为 redis 中的数字和浮点数都以字符串的形式保存，所以它们都属于字符串类型）
域 field 当前的值或给定的增量 increment 不能解释(parse)为双精度浮点数(double precision floating point number)
返回值：执行加法操作之后 field 域的值。