redis 哈希表(Hash)

HSET
HSET key field value
将哈希表key中的域field的值设为value。
如果key不存在，一个新的哈希表被创建并进行HSET操作。
如果域field已经存在于哈希表中，旧值将被覆盖。
返回值：
*如果field是哈希表中的一个新建域，并且值设置成功，返回1。
如果哈希表中域field已经存在且旧值已被新值覆盖，返回0。*

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

HSETNX
HSETNX key field value （not exist）
将哈希表key中的域field的值设置为value，当且仅当域field不存在。
若域field已经存在，该操作无效。
如果key不存在，一个新哈希表被创建并执行HSETNX命令。
返回值：
*设置成功，返回1。
如果给定域已经存在且没有操作被执行，返回0。*

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

HMSET
HMSET key field value [field value …]
同时将多个field - value(域-值)对设置到哈希表key中。
此命令会覆盖哈希表中已存在的域。
如果key不存在，一个空哈希表被创建并执行HMSET操作。
返回值：
*如果命令执行成功，返回OK。
当key不是哈希表(hash)类型时，返回一个错误。*

# 情况1： 哈希表redis> HMSET website google www.google.com yahoo www.yahoo.comOKredis> HGET website google"www.google.com"redis> HGET website yahoo"www.yahoo.com"# 情况2：类型错误时redis> SET G 10  # 出错情况OKredis> HMSET G name huangz age 20(error) ERR Operation against a key holding the wrong kind of value

HGET
HGET key field
返回哈希表key中给定域field的值。
返回值：
*给定域的值。
当给定域不存在或是给定key不存在时，返回nil。*

redis> HSET huangz blog huangz.iteye.com(integer) 1redis> HGET huangz blog"huangz.iteye.com"

HMGET
HMGET key field [field …]
返回哈希表key中，一个或多个给定域的值。
如果给定的域不存在于哈希表，那么返回一个nil值。
因为不存在的key被当作一个空哈希表来处理，所以对一个不存在的key进行HMGET操作将返回一个只带有nil值的表。
返回值：
一个包含多个给定域的关联值的表，表值的排列顺序和给定域参数的请求顺序一样。

redis> HMSET pet dog "doudou" cat "nounou"  # 一次保存多个值OKredis> HMGET pet dog cat fake_pet  # 返回值的顺序和传入参数的顺序一样。1) "doudou"2) "nounou"3) (nil)  # 不存在的域返回nil值

HGETALL
HGETALL key
返回哈希表key中，所有的域和值。
在返回值里，紧跟每个域名(field name)之后是域的值(value)，所以返回值的长度是哈希表大小的两倍。
返回值：
以列表形式返回哈希表的域和域的值。 若key不存在，返回空列表。
redis> HSET hash_name jack “Jack Sparrow”
(integer) 1

redis> HSET hash_name jack "Jack Sparrow"(integer) 1redis> HSET hash_name gump "Forrest Gump"(integer) 1redis> HGETALL hash_name1) "jack"          # 域2) "Jack Sparrow"  # 值3) "gump"4) "Forrest Gump"

HDEL
HDEL key field [field …]
删除哈希表key中的一个或多个指定域，不存在的域将被忽略。

返回值:
被成功移除的域的数量，不包括被忽略的域。
Note
在Redis2.4以下的版本里，HDEL每次只能删除单个域，如果你需要在一个原子时间内删除多个域，请将命令包含在MULTI/ EXEC块内。

# 测试数据redis> HGETALL abbr1) "a"2) "apple"3) "b"4) "banana"5) "c"6) "cat"7) "d"8) "dog"# 删除单个域redis> HDEL abbr a(integer) 1# 删除不存在的域redis> HDEL abbr not-exists-field(integer) 0# 删除多个域redis> HDEL abbr b c(integer) 2redis> HGETALL abbr1) "d"2) "dog"

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

redis> HSET hash_name jack "Jack Sparrow"(integer) 1redis> HSET hash_name gump "Forrest Gump"(integer) 1redis> HLEN hash_name(integer) 2

HEXISTS
HEXISTS key field
查看哈希表key中，给定域field是否存在。
返回值：
*如果哈希表含有给定域，返回1。
如果哈希表不含有给定域，或key不存在，返回0。*

redis> HEXISTS phone myphone(integer) 0redis> HSET phone myphone nokia-1110(integer) 1redis> HEXISTS phone myphone(integer) 1

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

# 情况1：increment为正数redis> HEXISTS counter page_view # 对空域进行设置(integer) 0redis> HINCRBY counter page_view 200(integer) 200redis> HGET counter page_view"200"# 情况2：increment为负数redis> HGET counter page_view"200"redis> HINCRBY counter page_view -50(integer) 150redis> HGET counter page_view"150"# 情况3：尝试对字符串值的域执行HINCRBY命令redis> HSET myhash string hello,world    # 设定一个字符串值(integer) 1redis> HGET myhash string"hello,world"redis> HINCRBY myhash string 1   # 命令执行失败，错误。(error) ERR hash value is not an integerredis> HGET myhash string    # 原值不变"hello,world"

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

# 情况1：哈希表非空redis> HMSET website google www.google.com yahoo www.yahoo.comOKredis> HKEYS website1) "google"2) "yahoo"# 情况2：空哈希表/key不存在redis> EXISTS fake_key(integer) 0redis> HKEYS fake_key(empty list or set)

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

redis> HMSET website google www.google.com yahoo www.yahoo.comOKredis> HVALS website1) "www.google.com"2) "www.yahoo.com"# 情况2：空哈希表/不存在的keyredis> EXISTS not_exists(integer) 0redis> HVALS not_exists(empty list or set)