Redis缓存命令整理—Hash（哈希表）操作命令

Hash（哈希表）操作命令

 

HDEL：HDEL key field [field ...]

描述：删除哈希表 key 中的一个或多个指定域，不存在的域将被忽略。

HDELMULTIEXEC在Redis2.4以下的版本里，  每次只能删除单个域，如果你需要在一个原子时间内删除多个域，请将命令包含在  /  块内。

返回值：被成功移除的域的数量，不包括被忽略的域。

 

HEXISTS ：HEXISTS  key field

描述：查看哈希表 key 中，给定域 field 是否存在。

返回值：如果哈希表含有给定域，返回 1 。

如果哈希表不含有给定域，或 key 不存在，返回 0 。

 

HGET：HGET key field

描述：返回哈希表 key 中给定域 field 的值。

返回值：给定域的值。

当给定域不存在或是给定 key 不存在时，返回 nil 。

 

HGETALL：HGETALL key

描述：返回哈希表 key 中，所有的域和值。

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

返回值：以列表形式返回哈希表的域和域的值。

若 key 不存在，返回空列表。

 

HINCRBY：HINCRBY key field increment

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

增量也可以为负数，相当于对给定域进行减法操作。

HINCRBY如果 key 不存在，一个新的哈希表被创建并执行  命令。

如果域 field 不存在，那么在执行命令前，域的值被初始化为 0 。

HINCRBY对一个储存字符串值的域 field 执行  命令将造成一个错误。

本操作的值被限制在 64位(bit)有符号数字表示之内。

HINCRBY返回值：执行  命令之后，哈希表 key 中域 field 的值。

 

HINCRBYFLOAT ：HINCRBYFLOAT key field increment

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

HINCRBYFLOAT如果哈希表中没有域 field ，那么  会先将域 field 的值设为 0 ，然后再执行加法操作。

HINCRBYFLOAT如果键 key 不存在，那么  会先创建一个哈希表，再创建域 field ，最后再执行加法操作。

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

 域 field 的值不是字符串类型(因为redis 中的数字和浮点数都以字符串的形式保存，所以它们都属于字符串类型）

 域 field 当前的值或给定的增量 increment 不能解释(parse)为双精度浮点数(double precision floating point number)

HINCRBYFLOATINCRBYFLOATINCRBYFLOAT 命令的详细功能和  命令类似，请查看  命令获取更多相关信息。

返回值：执行加法操作之后 field 域的值。

 

HKEYS：HKEYS key

描述：返回哈希表 key 中的所有域。

返回值：一个包含哈希表中所有域的表。

当 key 不存在时，返回一个空表。

 

HLEN：HLEN key

描述：返回哈希表 key 中域的数量。

返回值：哈希表中域的数量。

当 key 不存在时，返回 0 。

 

HMGET：HMGET key field [field ...]

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

如果给定的域不存在于哈希表，那么返回一个 nil 值。

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

返回值：一个包含多个给定域的关联值的表，表值的排列顺序和给定域参数的请求顺序一样。

 

HMSET：HMSET key field value [field value ...]

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

此命令会覆盖哈希表中已存在的域。

HMSET如果 key 不存在，一个空哈希表被创建并执行  操作。

返回值：如果命令执行成功，返回 OK 。

当 key 不是哈希表(hash)类型时，返回一个错误。

 

HSET：HSET key field value

描述：将哈希表 key 中的域 field 的值设为 value 。

HSET如果 key 不存在，一个新的哈希表被创建并进行  操作。

如果域 field 已经存在于哈希表中，旧值将被覆盖。

返回值：如果 field 是哈希表中的一个新建域，并且值设置成功，返回 1 。

如果哈希表中域 field 已经存在且旧值已被新值覆盖，返回 0 。

 

HSETNX：HSETNX key field value

描述：将哈希表 key 中的域 field 的值设置为 value ，当且仅当域 field 不存在。

若域 field 已经存在，该操作无效。

HSETNX如果 key 不存在，一个新哈希表被创建并执行  命令。

返回值：设置成功，返回 1 。

如果给定域已经存在且没有操作被执行，返回 0 。

 

HVALS：HVALS key

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

返回值：一个包含哈希表中所有值的表。

当 key 不存在时，返回一个空表。

 

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