@toc

一、常用命令

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 域的值。

1.10 HMSET key field value [field value …]

同时将多个 field-value (域-值)对设置到哈希表 key 中。

此命令会覆盖哈希表中已存在的域。 如果 key 不存在，一个空哈希表被创建并执行 HMSET 操作。

返回值：
如果命令执行成功，返回 OK 。
当 key 不是哈希表(hash)类型时，返回一个错误。

1.11 HMGET key field [field …]

返回哈希表 key 中，一个或多个给定域的值。

如果给定的域不存在于哈希表，那么返回一个 nil 值。 因为不存在的 key 被当作一个空哈希表来处理，所以对一个不存在的 key 进行
HMGET 操作将返回一个只带有 nil 值的表。

1.12 HKEYS key

返回哈希表 key 中的所有域。
返回值：一个包含哈希表中所有域的表。
当 key 不存在时，返回一个空表。

1.13 HVALS key

返回哈希表 key 中所有域的值。

1.14 HGETALL key

返回哈希表 key 中，所有的域和值。
在返回值里，紧跟每个域名(field name)之后是域的值(value)，所以返回值的长度是哈希表大小的两倍。

1.15 HSCAN key cursor [MATCH pattern] [COUNT count]

迭代哈希表中的键值对

二、实操

将hash表user中域id值设为11

hset user id 11

查看设置的id

hget user id

再将hash表user的name域设置z3

hset user name z3

同时将多个 field-value (域-值)对设置到哈希表 key 中。

hmset customer id 11 name li4 age 26

查看

hmget customer id name age

返回哈希表 customer 中，所有的域和值。

HGETALL customer

删除hash表user的name域

hdel user name

返回Hash表user和customer中域的数量

hlen user
hlen customer

检查域id和email是否存在哈希表customer中

HEXISTS customer id

HEXISTS customer email

返回hash表customer中的所有域

hkeys customer

返回哈希表customer中所有域的值

HVALS customer

为哈希表 customer 中的域 age 的值加上增量2 。

HINCRBY customer age 2

为哈希表customer再加一个域score

hset customer score 91.5

然后再给score增加0.5

HINCRBYFLOAT customer score 0.5

当且仅当域 age尚未存在于哈希表的情况下， 将它的值设置为25

hsetnx customer age 25

由于存在域age,所以操作失败

当且仅当域 email尚未存在于哈希表的情况下， 将它的值设置为abc@126.com

hsetnx customer email abc@126.com

由于哈希表customer中不存在域email，所以设置成功