注意:此文档已经过期,请移步到 http://huangz.iteye.com/blog/1123512 查看最新翻译。
BLPOP key [key ...] timeout
BLPOP是一个阻塞列表的弹出原语。
它是LPOP的阻塞版本,当给定列表内没有任何元素可供弹出的时候,连接将被BLPOP命令阻塞。
当给定多个key参数时,按传入key的先后检查列表,弹出第一个非空列表的头部元素。
复杂度:
O(1)
返回值:
假如在指定时间内没有任何元素被弹出,则返回一个nil和等待时长。
反之,返回一个含有两个元素的列表,第一个是被弹出元素所属的key,第二个是被弹出元素的值。
非阻塞行为
当BLPOP被调用时,如果给定key内至少有一个非空列表,那么弹出遇到的第一个非空列表的头部元素,并和被弹出元素所属的列表的名字一起,组成结果>返回给调用者。
(多个)给定key按被传入的先后顺序被检查。
假设现在job不存在,command和request都持有非空列表。考虑以下命令:
BLPOP job command request
BLPOP保证返回的元素来自command,因为它是第一个按“查找job -> 查找command -> 查找request”这样的顺序,第一个找到的非空列表。
redis> DEL job command request # 确保key都被删除 (integer) 0 redis> LPUSH command "update system..." # 为command列表增加一个值 (integer) 1 redis> LPUSH request "visit page" # 为request列表增加一个值 (integer) 1 redis> BLPOP job command request 0 # job列表为空,被跳过,紧接着command列表的第一个元素被弹出。 1) "command" 2) "update system..."
阻塞行为
如果所有给定key都不存在或包含空列表,那么BLPOP将阻塞连接,直到另一个客户端对给定key的其中一个列表执行LPUSH或RPUSH操作,或操作超时为止。
如果在规定时间内新数据出现在其中一个key列表内,或者等待超时,都会导致返回。
超时参数接受一个数字作为值。超时参数设为0表示阻塞时间可以无限期延长(block indefinitely) 。
相同的key被多个客户端同时阻塞
相同的key可以被多个客户端同时阻塞。不同的客户端被放到一个队列中,按“先阻塞先服务”的顺序同key进行BLPOP操作。
redis> EXISTS job # 确保两个key都不存在 (integer) 0 redis> EXISTS command (integer) 0 redis> BLPOP job command 300 #因为key一开始不存在,所以操作会被阻塞,直到另一客户端对job或者command列表进行PUSH操作。 1) "job" # 这里被push的是job 2) "do my home work" # 被弹出的内容 (26.26s) # 等待的秒数 redis> BLPOP job command 5 # 等待超时的情况 (nil) (5.66s)
在MULTI/EXEC事务中的BLPOP
BLPOP可以用于流水线(批量地发送多个命令并阅读多个回复),但它不能用在MULTI/EXEC块当中。这要求整个服务器按顺序被阻塞以保证块执行时的原子
性,该行为阻止了其他客户端执行push操作。
一个被包含在MULTI/EXEC命令内的BLPOP操作,行为表现得就像操作超时一样,仅仅返回一个nil值。如果你是科幻迷,你可以想象MULTI/EXEC命令内时间>以无限的速度在流逝。
redis> MULTI OK redis> BLPOP job 30 QUEUED redis> EXEC 1) (nil) # 操作没有等待,立即被返回了
LLEN key
返回key所储存列表的长度。
如果key不存在,则key被解释为一个空列表,返回0.
如果key储存的不是列表,返回一个错误。
复杂度:
O(1)
返回值:
key中列表的长度。
redis> LLEN job # 空列表 (integer) 0 redis> LPUSH job "cook food" (integer) 1 redis> LPUSH job "have lunch" (integer) 2 redis> LLEN job (integer) 2
LREM key count value
按照count参数的要求,移除列表中与value参数相等的值。
count参数可以是以下几种:
count > 0 : 从表头开始向表尾搜索,移除与value参数相等的值。
count < 0 : 从表尾开始向表头搜索,移除与value参数相等的值。
count = 0 : 移除表中所有与value相等的值。
复杂度:
O(N),N为列表的长度。
返回值:
被移除值的数量。
# 先创建一个表,内容排列是
# morning hello morning helllo morning
redis> LPUSH greet "morning"
(integer) 1
redis> LPUSH greet "hello"
(integer) 2
redis> LPUSH greet "morning"
(integer) 3
redis> LPUSH greet "hello"
(integer) 4
redis> LPUSH greet "morning"
(integer) 5
redis> LRANGE greet 0 4
1) "morning"
2) "hello"
3) "morning"
4) "hello"
5) "morning"
redis> LREM greet 2 morning # 移除从表头到表尾,最先发现的两个morning
(integer) 2 # 两个元素被移除
redis> LLEN greet
(integer) 3
redis> LRANGE greet 0 2
1) "hello"
2) "hello"
3) "morning"
redis> LREM greet -1 morning # 移除从表尾到表头,第一个morning
(integer) 1
redis> LLEN greet
(integer) 2
redis> LRANGE greet 0 1
1) "hello"
2) "hello"
redis> LREM greet 0 hello # 移除表中所有hello
(integer) 2 # 两个hello被移除
redis> LLEN greet
(integer) 0
RPUSH key value
将值插入到表尾。
如果key不存在,一个空列表会被自动创建再执行RPUSH操作。
当key存在当不是列表类型时,返回一个错误。
复杂度:
O(1)
返回值:
执行RPUSH操作后,表的长度。
redis> LLEN fp-language (integer) 0 redis> RPUSH fp-language lisp (integer) 1 redis> LRANGE fp-language 0 0 1) "lisp" redis> RPUSH fp-language scheme (integer) 2 redis> LRANGE fp-language 0 1 1) "lisp" 2) "scheme"
BRPOP key [key ...] timeout
RPOP操作的阻塞版本,作用和BLPOP相似,唯一不同是BRPOP弹出第一个非空列表的表尾元素,而BLPOP弹出第>一个非空列表的表头元素。(具体参考BLPOP命令)。
复杂度:
O(1)
返回值:
假如在指定时间内没有任何元素被弹出,则返回一个nil和等待时长。
反之,返回一个含有两个元素的列表,第一个是被弹出元素所属的key,第二>个是被弹出元素的值。
redis> LLEN course (integer) 0 redis> RPUSH course algorithm001 (integer) 1 redis> RPUSH course c++101 (integer) 2 redis> BRPOP course 30 1) "course" 2) "c++101"
LPOP key
移除并返回列表中第一个元素。
复杂度:
O(1)
返回值:
列表中第一个值。
当key不存在时,返回nil。
redis> LLEN course (integer) 0 redis> RPUSH course algorithm001 (integer) 1 redis> RPUSH course c++101 (integer) 2 redis> LPOP course "algorithm001"
LSET key index value
将列表中index下标的值设为value。
更多信息参考LINDEX操作。
当index参数超出范围时,返回一个错误。
复杂度:
O(N),N为列表的长度。
对头元素和尾元素进行LSET操作,复杂度为O(1)。
返回值:
操作成功返回ok,否则返回错误信息。
redis> LPUSH job "cook food" (integer) 1 redis> LRANGE job 0 0 1) "cook food" redis> LSET job 0 "play game" OK redis> LRANGE job 0 0 1) "play game"
RPUSHX key value
将值value插入到表尾,当且仅当key存在并且是一个列表。
和RPUSH操作相反,当key不存在时,RPUSHX操作什么也不做。
复杂度:
O(1)
返回值:
RPUSHX操作之后,表的长度。
redis> LLEN greet (integer) 0 redis> RPUSHX greet "hello" # 对不存在的key进行RPUSHX,PUSH失败。 (integer) 0 redis> RPUSH greet "hi" # 先用RPUSH插入一个元素 (integer) 1 redis> RPUSHX greet "hello" # greet现在是一个列表类型,RPUSHX操作成功。 (integer) 2
######防止编辑器吃掉空白行