日期:2014-05-16  浏览次数:20486 次

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值
?

<