Redis命令参考(Commands Reference)中文翻译【Hash部分】
注意:此文档已经过期,请移步到?http://huangz.iteye.com/blog/1123512?查看最新翻译。
?
HASH部分
HDEL key field?
??? 删除key储存的哈希表(hash)中的指定域(field)。
??????? 复杂度:
??????????? O(1)
??????? 返回值:
??????????? 若域存在并被成功删除,返回1。?
??????????? 若key不存在或域不存在,返回0。
redis> HSET hash_name jack "Jack Sparrow"
(integer) 1
redis> HGET hash_name jack
"Jack Sparrow"
redis> HDEL hash_name jack
(integer) 1
redis> HGET hash_name jack
(nil)
?
HGETALL key?
??? 返回key储存的哈希表中所有的域和值。
??? 在返回值里,每个域名(field name)之后是域的值(value),所以返回值的长度是哈希表大小的两倍。
??????? 复杂度:
??????????? O(N),N为哈希表的大小。
??????? 返回值:
??????????? 以列表形式返回哈希表的域和值。
??????????? 若key不存在,返回空列表。
redis> HSET hash_name jack "Jack Sparrow"
(integer) 1
redis> HSET hash_name gump "Forrest Gump"
(integer) 1
redis> HGETALL hash_name
1) "jack" # 域
2) "Jack Sparrow" # 值
3) "gump"
4) "Forrest Gump"
?
HLEN key
??? 返回key储存的哈希表中域的数量。
??????? 复杂度:
??????????? O(1)
??????? 返回值:
??????????? 哈希表中域的数量。
??????????? 当key不存在时,返回0。
redis> HSET hash_name jack "Jack Sparrow"
(integer) 1
redis> HSET hash_name gump "Forrest Gump"
(integer) 1
redis> HLEN hash_name
(integer) 2
?
HSET key field value?
??? 将key储存的哈希表中的field域设置为value值。
??? 如果key不存在,一个新的哈希表被创建并进行HSET操作。
??? 如果域已经存在于哈希表中,旧值将被覆盖。
????
??????? 复杂度:
??????????? O(1)
??????? 返回值:
??????????? 如果一个哈希表中的新域被设置,返回1。
??????????? 如果哈希表中域已经存在且旧值已被新值覆盖,返回0。
redis> HSET website google "www.g.cn"
(integer) 1
redis> HSET website google "www.google.com"
(integer) 0
?
HEXISTS key field?
??? 查看key储存的哈希表中,指定域是否存在。
??????? 复杂度:
??????????? O(1)
??????? 返回值:
??????????? 如果哈希表含有指定域,返回1。
??????????? 如果哈希表不含有指定域,或key不存在,返回0。
redis> HEXISTS phone myphone
(integer) 0
redis> HSET phone myphone nokia-1110
(integer) 1
redis> HEXISTS phone myphone
(integer) 1
?
HINCRBY key field increment
??? 将key所储存哈希表中的域的值加上increment。
??? 如果key不存在,一个新的哈希表被创建并执行HINCRBY操作。
??? 如果field域不存在,或域已有的字符串值不能表示为数字,那么在执行操作
前,域的值被设置为0。
??? 本操作只能对64位有符号数字使用。
????
??????? 复杂度:
??????????? O(1)
??????? 返回值:
??????????? HINCRBY操作完成之后,域的值。
redis> HEXISTS hash_count page_views
(integer) 0
redis> HINCRBY hash_count page_views 200
(integer) 200
redis> HINCRBY hash_count page_views 10
(integer) 210
?
HMGET key field [field ...]?
??? 返回key所储存的哈希表中,多个给定域的关联值。
??? 如果指定的域不存在于哈希表,那么返回一个nil值。
??? 因为不存在的key被当作一个空哈希表来处理,所以对一个不存在的key进行HMGET操作将返回一个只带有nil值的表。
??????? 复杂度:
??????????? O(N),N为给定域的数量。
??????? 返回值:
??????????? 一个包含多个给定域的关联值的表,表值的排列顺序和给定域参数的请求顺序一样。
redis> HMSET pet dog "doudou" cat "nounou" # 一次保存多个值
OK
redis> HMGET pet dog cat fake_pet # 返回值的顺序和传入参数的顺序一样。
1) "doudou"
2) "nounou"
3) (nil) # 不存在的域返回nil值
?
<