Redis基本数据结构之(Hash)

哈希表(Hash)

基本命令

HDEL

HDEL key field [field ...]

删除哈希表 key 中的一个或多个指定域,不存在的域将被忽略

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

示例:

HDEL hashSet b c

HEXISTS

HEXISTS key field

查看哈希表 key 中,给定域 field 是否存在。

返回值:如果哈希表含有给定域,返回 1 。如果哈希表不含有给定域,或 key 不存在,返回 0 。

示例:

HEXISTS phone myphone

HGET

HGET key field #返回哈希表 key 中给定域 field 的值。

返回值:给定域的值。当给定域不存在或是给定 key 不存在时,返回 nil

示例:

HSET site redis redis.com

HGETALL

HGETALL key

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

返回值:以列表形式返回哈希表的域和域的值。若 key 不存在,返回空列表。

示例:

redis> HSET people jack "Jack Sparrow"
(integer) 1

redis> HSET people gump "Forrest Gump"
(integer) 1

redis> HGETALL people
1) "jack"          # 域
2) "Jack Sparrow"  # 值
3) "gump"
4) "Forrest Gump"

HINCRBY

HINCRBY key field increment

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

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

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

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

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

返回值:执行 HINCRBY 命令之后,哈希表 key 中域 field 的值

示例:

HINCRBY counter page_view 200

HINCRBYFLOAT

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

示例:

HINCRBYFLOAT mykey field 2.0e2

HKEYS

HKEYS key  #返回哈希表 key 中的所有域

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

示例:

redis> HMSET website google www.google.com yahoo www.yahoo.com
OK

redis> HKEYS website
1) "google"
2) "yahoo"

HLEN

HLEN key   #返回哈希表 key 中域的数量

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

示例:

redis> HSET db redis redis.com
(integer) 1

redis> HSET db mysql mysql.com
(integer) 1

redis> HLEN db
(integer) 2

HMGET

HMGET key field [field ...]

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

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

示例:

redis> HMSET pet dog "doudou" cat "nounou"    # 一次设置多个域
OK

redis> HMGET pet dog cat fake_pet             # 返回值的顺序和传入参数的顺序一样
1) "doudou"
2) "nounou"
3) (nil)  

HMSET

HMSET key field value [field value ...]

同时将多个 field-value (域-值)对设置到哈希表 key 中。此命令会覆盖哈希表中已存在的域。如果 key 不存在,一个空哈希表被创建并执行 HMSET 操作。

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

示例:

redis> HMSET website google www.google.com yahoo www.yahoo.com
OK

redis> HGET website google
"www.google.com"

redis> HGET website yahoo
"www.yahoo.com"

HSET

HSET key field value

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

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

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

返回值:如果 field 是哈希表中的一个新建域,并且值设置成功,返回 1 。如果哈希表中域 field 已经存在且旧值已被新值覆盖,返回 0。

示例:

redis> HSET website google "www.g.cn"       # 设置一个新域
(integer) 1

redis> HSET website google "www.google.com" # 覆盖一个旧域
(integer) 0

HSETNX

HSETNX key field value

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

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

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

返回值:设置成功,返回 1 。如果给定域已经存在且没有操作被执行,返回 0 。

示例:

redis> HSETNX nosql key-value-store redis
(integer) 1

redis> HSETNX nosql key-value-store redis       # 操作无效,域 key-value-store 已存在
(integer) 0

HVALS

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

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

示例:

HVALS not_exists

你可能感兴趣的:(Redis基本数据结构之(Hash))