Redis 列表(List)

Redis 列表(List)

Redis列表是简单的字符串列表，按照插入顺序排序。你可以添加一个元素到列表的头部（左边）或者尾部（右边）

一个列表最多可以包含 ^{232 - 1} 个元素 (4294967295, 每个列表超过40亿个元素)。

实例

> lpush job job1
1
> lpush job job1
2
> lpush job job2
3
> lpush job job3
4
> lpush job job4
5
> lpush job job2
6
> lrange job 0 -1
job2
job4
job3
job2
job1
job1

list 命令

Blpop

Redis Blpop 命令移出并获取列表的第一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。

语法

BLPOP LIST1 LIST2 .. LISTN TIMEOUT

返回值

如果列表为空，返回一个 nil 。

否则，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的 key ，第二个元素是被弹出元素的值。

实例

> blpop job 100
job
job2
> blpop job 100
job
job4
> lrange job 0 -1
job3
job2
job1
job1

Brpop

Redis Brpop 命令移出并获取列表的最后一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。

语法

 BRPOP LIST1 LIST2 .. LISTN TIMEOUT

返回值

假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。 反之，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的 key ，第二个元素是被弹出元素的值。

实例

> brpop job 100
job
job1
> brpop job 100
job
job1
> lrange job 0 -1
job3
job2

Brpoplpush

Redis Brpoplpush 命令从列表中取出最后一个元素，并插入到另外一个列表的头部； 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。

语法

BRPOPLPUSH LIST1 ANOTHER_LIST TIMEOUT 

返回值

假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。

反之，返回一个含有两个元素的列表，第一个元素是被弹出元素的值，第二个元素是等待时长。

实例

> brpoplpush job task 100
job2
> brpoplpush job task 100
job3
> brpoplpush job task 100
job5
> lrange task 0 -1
job5
job3
job2

Lindex

Redis Lindex 命令用于通过索引获取列表中的元素。你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。

语法

LINDEX KEY_NAME INDEX_POSITION 

返回值

列表中下标为指定索引值的元素。 如果指定索引值不在列表的区间范围内，返回 nil 。

实例

> lindex job 0
job7
> lindex job -1
job6
> lindex job -2
job7
> lindex job -3
null

Linsert

Redis Linsert 命令用于在列表的元素前或者后插入元素。当指定元素不存在于列表中时，不执行任何操作。

当列表不存在时，被视为空列表，不执行任何操作。

如果 key 不是列表类型，返回一个错误。

语法

LINSERT key BEFORE|AFTER pivot value

返回值

如果命令执行成功，返回插入操作完成之后，列表的长度。 如果没有找到指定元素 ，返回 -1 。 如果 key 不存在或为空列表，返回 0 。

实例

> linsert task before job3 job10
4
> lrange task 0 -1
job5
job10
job3
job2

Llen

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

语法

LLEN KEY_NAME 

返回值

列表的长度。

实例

> llen task
4

Lpop

Redis Lpop 命令用于移除并返回列表的第一个元素。

语法

Lpop KEY_NAME 

返回值

列表的第一个元素。 当列表 key 不存在时，返回 nil 。

实例

> lpop  job
job7
> llen job
1

Lpush

Redis Lpush 命令将一个或多个值插入到列表头部。 如果 key 不存在，一个空列表会被创建并执行 LPUSH 操作。 当 key 存在但不是列表类型时，返回一个错误。

注意：在Redis 2.4版本以前的 LPUSH 命令，都只接受单个 value 值。

语法

LPUSH KEY_NAME VALUE1.. VALUEN

返回值

执行 LPUSH 命令后，列表的长度。

实例

> lpush job job2 job3 job4 job2 job5
6
> llen job
6

Lpushx

Redis Lpushx 将一个值插入到已存在的列表头部，列表不存在时操作无效。

语法

LPUSHX KEY_NAME VALUE1.. VALUEN

返回值

LPUSHX 命令执行之后，列表的长度。

实例

> lpushx schedule job2 job3 job4 job2 job5
0
> llen schedule
0
> exists schedule
0

Lrange

Redis Lrange 返回列表中指定区间内的元素，区间以偏移量 START 和 END 指定。 其中 0 表示列表的第一个元素， 1 表示列表的第二个元素，以此类推。 你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。

语法

LRANGE KEY_NAME START END

返回值

一个列表，包含指定区间内的元素。

实例

> lrange job 0 100
job5
job2
job4
job3
job2
job6

Lrem

Redis Lrem 根据参数 COUNT 的值，移除列表中与参数 VALUE 相等的元素。

COUNT 的值可以是以下几种：

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

语法

LREM key count VALUE

返回值

被移除元素的数量。 列表不存在时返回 0 。

实例

> lrange job 0 100
job5
job2
job4
job3
job2
job6
> lrem job 0 job2
2
> lrange job 0 100
job5
job4
job3
job6

Lset

Redis Lset 通过索引来设置元素的值。

当索引参数超出范围，或对一个空列表进行 LSET 时，返回一个错误。

关于列表下标的更多信息，请参考 LINDEX 命令

语法

LSET KEY_NAME INDEX VALUE

返回值

操作成功返回 ok ，否则返回错误信息。

实例

> lrange job 0 100
job5
job4
job10
job6
> lset job 0 job1
OK
> lrange job 0 100
job1
job4
job10
job6

Ltrim

Redis Ltrim 对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。

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

语法

LTRIM KEY_NAME START STOP

返回值

命令执行成功时，返回 ok 。

实例

> lrange job 0 100
job1
job4
job10
job6
> ltrim job 1 -1
OK
> lrange job 0 100
job4
job10
job6

Rpop

Redis Rpop 命令用于移除列表的最后一个元素，返回值为移除的元素。

语法

RPOP KEY_NAME 

返回值

被移除的元素。

当列表不存在时，返回 nil 。

实例

> lrange job 0 100
job4
job10
job6
> rpop job
job6
> lrange job 0 100
job4
job10

Rpoplpush

Redis Rpoplpush 命令用于移除列表的最后一个元素，并将该元素添加到另一个列表并返回。

语法

RPOPLPUSH SOURCE_KEY_NAME DESTINATION_KEY_NAME

返回值

被弹出的元素。

实例

> rpoplpush job task
job10
> lrange job 0 100
job4
> lrange task 0 100
job10
job5
job10
job3
job2

Rpush

Redis Rpush 命令用于将一个或多个值插入到列表的尾部(最右边)。

如果列表不存在，一个空列表会被创建并执行 RPUSH 操作。 当列表存在但不是列表类型时，返回一个错误。

注意：在 Redis 2.4 版本以前的 RPUSH 命令，都只接受单个 value 值。

语法

RPUSH KEY_NAME VALUE1..VALUEN

返回值

执行 RPUSH 操作后，列表的长度。

实例

> rpush job job2 job3 job2 job4
5
> lrange job 0 100
job4
job2
job3
job2
job4

Rpushx

Redis Rpushx 命令用于将一个值插入到已存在的列表尾部(最右边)。如果列表不存在，操作无效。

语法

RPUSHX KEY_NAME VALUE1..VALUEN

返回值

执行 Rpushx 操作后，列表的长度。

实例

> rpushx job job2 job3 job2 job4
9
> lrange job 0 100
job4
job2
job3
job2
job4
job2
job3
job2
job4

思考

list真实业务有些真实应用场景