bee.cloud.cache

接口 Cache.Stack

封闭接口:

Cache

public static interface Cache.Stack

列表队列

方法概要

限定符和类型	方法和说明
long	llen() 返回列表 key 的长度。
String	lpop() 移除并返回列表 key 的头元素。
List<String>	lpop(int count) 移除并返回列表 key 的头元素。
void	lpush(String... values) 将一个或多个值 value 插入到列表 key 的表头(最左边)。
List<String>	lrange() 获取所有数据
List<String>	lrange(long start) 从指定位置开始获取后边的所有数据
List<String>	lrange(long start, long end) LRANGE key start stop 返回列表 key 中指定区间内的元素，区间以偏移量 start 和 stop 指定。
long	lrem(long count, String value) LREM key count value 根据参数 count 的值，移除列表中与参数 value 相等的元素。
String	rpop() 移除并返回列表 key 的尾元素。
List<String>	rpop(int count) 移除并返回列表 key 的尾元素。
void	rpush(String... values) 将一个或多个值 value 插入到列表 key 的表尾(最右边)。

方法详细资料

lpush

void lpush(String... values)

将一个或多个值 value 插入到列表 key 的表头(最左边)。 如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表头

参数:

values - -

rpush

void rpush(String... values)

将一个或多个值 value 插入到列表 key 的表尾(最右边)。 如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表尾

参数:

values - -

lpop

String lpop()

移除并返回列表 key 的头元素。

返回:

列表的头元素。 当 key 不存在时，返回 null 。

rpop

String rpop()

移除并返回列表 key 的尾元素。

返回:

列表的尾元素。。 当 key 不存在时，返回 null 。

lpop

List<String> lpop(int count)

移除并返回列表 key 的头元素。

参数:

count - -需要移除的数量

返回:

列表的头元素。 当 key 不存在时，返回 null 。

rpop

List<String> rpop(int count)

移除并返回列表 key 的尾元素。

参数:

count - -需要移除的数量

返回:

列表的尾元素。。 当 key 不存在时，返回 null 。

llen

long llen()

返回列表 key 的长度。 如果 key 不存在，则 key 被解释为一个空列表，返回 0 . 如果 key 不是列表类型，返回一个错误。

返回:

返回列表 key 的长度。

lrange

List<String> lrange(long start,
                    long end)

LRANGE key start stop

返回列表 key 中指定区间内的元素，区间以偏移量 start 和 stop 指定。

下标(index)参数 start 和 stop 都以 0 为底，也就是说，以 0 表示列表的第一个元素，以 1 表示列表的第二个元素，以此类推。

你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。

注意LRANGE命令和编程语言区间函数的区别

假如你有一个包含一百个元素的列表，对该列表执行 LRANGE list 0 10 ，结果是一个包含11个元素的列表，这表明 stop 下标也在 LRANGE 命令的取值范围之内(闭区间)，这和某些语言的区间函数可能不一致，比如Ruby的 Range.new 、 Array#slice 和Python的 range() 函数。

超出范围的下标

超出范围的下标值不会引起错误。

如果 start 下标比列表的最大下标 end ( LLEN list 减去 1 )还要大，或者 start > stop ， LRANGE 返回一个空列表。

如果 stop 下标比 end 下标还要大，Redis将 stop 的值设置为 end 。

参数:

start - -

end - -

返回:

-

lrange

List<String> lrange(long start)

从指定位置开始获取后边的所有数据

参数:

start - -

返回:

-

lrange

List<String> lrange()

获取所有数据

返回:

-

lrem

long lrem(long count,
          String value)

LREM key count value

根据参数 count 的值，移除列表中与参数 value 相等的元素。

count 的值可以是以下几种：

• count > 0 : 从表头开始向表尾搜索，移除与 value 相等的元素，数量为 count 。
• count < 0 : 从表尾开始向表头搜索，移除与 value 相等的元素，数量为 count 的绝对值。
• count = 0 : 移除表中所有与 value 相等的值。

时间复杂度：

O(N)， N 为列表的长度。

返回值：

被移除元素的数量。

因为不存在的 key 被视作空表(empty list)，所以当 key 不存在时， LREM 命令总是返回 0 。

参数:

count - -

value - -

返回:

-