1.HDEL
HDEL key field [field......]
删除哈希表key中一个或多个指定域,不存在的域将被忽略
返回值:
被成功移除的域的数量,不包括被忽略的域。
命令:
# 测试数据
redis> HGETALL abbr
1) "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) 2
redis> HGETALL abbr
1) "d"
2) "dog"
2.HEXISTS
HEXISTS key field
查看哈希表key中,给定域field是否存在
返回值:
如果哈希表含有给给定域,返回1.
如果哈希表不含有给定域,或key不存在,返回0.
命令:
redis> HEXISTS phone myphone
(integer) 0
redis> HSET phone myphone nokia-1110
(integer) 1
redis> HEXISTS phone myphone
(integer) 1
3.HGET
HGET key field
返回哈希表key中给定域field的值。
返回值:
给定域的值。
当给定域不存在或是给定key不存在时,返回nil。
命令:
# 域存在
redis> HSET site redis redis.com
(integer) 1
redis> HGET site redis
"redis.com"
# 域不存在
redis> HGET site mysql
(nil)
4.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"
5.HINCRBY
HINCRBY key field increment
为哈希表key中的域field的值增加上增量increment。
增量也可以是负数,相当于对给定域进行减法操作。
如果key不存在,一个新的哈希表被创建并执行HINCRBY命令。
如果field不存在,那么在执行命令前,域的值被初始化为0。
对一个储存字符串值的域field执行HINCRBY命令将造成一个错误。
本操作的值被限制在64位(bit)有符号数字表示之内。
返回值:
执行HINCRBY命令之后,哈希表key中域field的值。
命令:
# increment 为正数
redis> HEXISTS counter page_view # 对空域进行设置
(integer) 0
redis> HINCRBY counter page_view 200
(integer) 200
redis> HGET counter page_view
"200"
# increment 为负数
redis> HGET counter page_view
"200"
redis> HINCRBY counter page_view -50
(integer) 150
redis> HGET counter page_view
"150"
# 尝试对字符串值的域执行HINCRBY命令
redis> HSET myhash string hello,world # 设定一个字符串值
(integer) 1
redis> HGET myhash string
"hello,world"
redis> HINCRBY myhash string 1 # 命令执行失败,错误。
(error) ERR hash value is not an integer
redis> HGET myhash string # 原值不变
"hello,world"
6.HINCRBYFLOAT
HINCRBYFLOAT key field increment
为哈希表key中的域field加上浮点数增量increment。
如果哈希表中没有域field,那么HINCRBYFLOAT会先将域field的值设为0,然后再执行加法操作。
如果键key不存在,那么HINCRBYFLOAT会先创建一个哈希表,再创建域field,最后再执行加法操作。
当以下任意一个条件发生时,返回一个错误:
①域field的值不是字符串类型(因为redis中的数字和浮点数都是以字符串的形式保存,所以它们都属于字符串类型)
②域field当前的值或给定的增量increment不能解释为双精度浮点数。
返回值:
执行加法操作之后field域的值。
命令:
# 值和增量都是普通小数
redis> HSET mykey field 10.50
(integer) 1
redis> HINCRBYFLOAT mykey field 0.1
"10.6"
# 值和增量都是指数符号
redis> HSET mykey field 5.0e3
(integer) 0
redis> HINCRBYFLOAT mykey field 2.0e2
"5200"
# 对不存在的键执行 HINCRBYFLOAT
redis> EXISTS price
(integer) 0
redis> HINCRBYFLOAT price milk 3.5
"3.5"
redis> HGETALL price
1) "milk"
2) "3.5"
# 对不存在的域进行 HINCRBYFLOAT
redis> HGETALL price
1) "milk"
2) "3.5"
redis> HINCRBYFLOAT price coffee 4.5 # 新增 coffee 域
"4.5"
redis> HGETALL price
1) "milk"
2) "3.5"
3) "coffee"
4) "4.5"
7.HKEYS
HKEYS key
返回哈希表key中所有域
返回值:
一个包含哈希表中所有域的表。
当key不存在时,返回一个空表。
命令:
# 哈希表非空
redis> HMSET website google www.google.com yahoo www.yahoo.com
OK
redis> HKEYS website
1) "google"
2) "yahoo"
# 空哈希表/key不存在
redis> EXISTS fake_key
(integer) 0
redis> HKEYS fake_key
(empty list or set)
8.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
redis> HSET db mongodb mongodb.org
(integer) 1
redis> HLEN db
(integer) 3
9.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) # 不存在的域返回nil值
10.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"
11.HSET
HSET key field value
将哈希表key中的域field的值设为value。
如果key不存在,一个新的哈希表被创建并进行HSET操作。
如果域field已经存在于哈希表中,旧值将被覆盖。
返回值:
如果field是哈希表中一个新建域,并且值设置成功,返回1。
如果哈希表中域field已经存在且旧值已被新值覆盖,返回0。
命令:
redis> HSET website google "www.g.cn" # 设置一个新域
(integer) 1
127.0.0.1:6379> hget website google
"www.google.com"
127.0.0.1:6379> hset website google "kk"
(integer) 0
127.0.0.1:6379> hget website google
"kk"
12.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
13.HVALS
HVALS key
返回哈希表key中所有域的值。
返回值:
一个包含哈希表中所有值的表。
当key不存在时,返回一个空表。
命令:
# 非空哈希表
redis> HMSET website google www.google.com yahoo www.yahoo.com
OK
127.0.0.1:6379> hvals website
1) "www.google.com"
2) "www.yahoo.com"
127.0.0.1:6379> hkeys website
1) "google"
2) "yahoo"
# 空哈希表/不存在的key
redis> EXISTS not_exists
(integer) 0
redis> HVALS not_exists
(empty list or set)
14.HSTRLEN
HSTRLEN key field
返回哈希表key中,与给定域field相关联的值的字符串长度(string length)。
如果给定的键或者域不存在,那么命令返回0。
返回值:
一个整数。
命令:
redis> HMSET myhash f1 "HelloWorld" f2 "99" f3 "-256"
OK
redis> HSTRLEN myhash f1
(integer) 10
redis> HSTRLEN myhash f2
(integer) 2
redis> HSTRLEN myhash f3
(integer) 4