redis list 数据类型_redis list数据类型-优快云博客

本文链接：https://blog.youkuaiyun.com/azh89125/article/details/123544684

1、概述

List类型是按照插入顺序排序的字符串链表。和数据结构中的普通链表一样，我们可以在其头部(left)和尾部(right)添加新的元素。在插入时，如果该键并不存在，Redis将为该键创建一个新的链表。与此相反，如果链表中所有的元素均被移除，那么该键也将会被从数据库中删除。List中可以包含的最大元素数量是 $2^{32}$ -1个

2、常见命令

LPUSH：在指定Key所关联的List Value的头部插入参数中给出的所有Values。如果该Key不存在，该命令将在插入之前创建一个与该Key关联的空链表，之后再将数据从链表的头部插入。如果该键的Value不是链表类型，该命令将返回相关的错误信息。

LPUSHX：仅有当参数中指定的Key存在时，该命令才会在其所关联的List Value的头部插入参数中给出的Value，否则将不会有任何操作发生。

LRANGE key start stop ：该命令的参数start和end都是0-based。即0表示链表头部(leftmost)的第一个元素。其中start的值也可以为负值，-1将表示链表中的最后一个元素，即尾部元素，-2表示倒数第二个并以此类推。该命令在获取元素时，start和end位置上的元素也会被取出。如果start的值大于链表中元素的数量，空链表将会被返回。如果end的值大于元素的数量，该命令则获取从start(包括start)开始，链表中剩余的所有元素。

LPOP key：返回并弹出指定Key关联的链表中的第一个元素，即头部元素，。如果该Key不存，返回nil。

LLEN key：返回指定Key关联的链表中元素的数量，如果该Key不存在，则返回0。如果与该Key关联的Value的类型不是链表，则返回相关的错误信息。

LREM key count value：在指定Key关联的链表中，删除前count个值等于value的元素。如果count大于0，从头向尾遍历并删除，如果count小于0，则从尾向头遍历并删除。如果count等于0，则删除链表中所有等于value的元素。如果指定的Key不存在，则直接返回0。

LSET key index value：设定链表中指定位置的值为新值，其中0表示第一个元素，即头部元素，-1表示尾部元素。如果索引值Index超出了链表中元素的数量范围，该命令将返回相关的错误信息。

LINDEX key index：该命令将返回链表中指定位置(index)的元素，index是0-based，表示头部元素，如果index为-1，表示尾部元素。如果与该Key关联的不是链表，该命令将返回相关的错误信息。

LTRIM key start stop：start和stop参数都是0-based，0表示头部元素。和其他命令一样，start和stop也可以为负值，-1表示尾部元素。如果start大于链表的尾部，或start大于stop，该命令不错报错，而是返回一个空的链表，与此同时该Key也将被删除。如果stop大于元素的数量，则保留从start开始剩余的所有元素。

LINSERT key BEFORE|AFTER pivot value ：这样意味着如果pivot位于链表的头部或尾部时。该命令的功能是在pivot元素的前面或后面插入参数中的元素value。如果Key不存在，该命令将不执行任何操作。如果与Key关联的Value类型不是链表，相关的错误信息将被返回。

RPUSH key value [value ...] ：在指定Key所关联的List Value的尾部插入参数中给出的所有Values。如果该Key不存在，该命令将在插入之前创建一个与该Key关联的空链表，之后再将数据从链表的尾部插入。如果该键的Value不是链表类型，该命令将返回相关的错误信息。

RPUSHX key value ：仅有当参数中指定的Key存在时，该命令才会在其所关联的List Value的尾部插入参数中给出的Value，否则将不会有任何操作发生。

RPOP key：返回并弹出指定Key关联的链表中的最后一个元素，即尾部元素，如果该Key不存，返回nil。

RPOPLPUSH source destination：原子性的从与source键关联的链表尾部弹出一个元素，同时再将弹出的元素插入到与destination键关联的链表的头部。如果source键不存在，该命令将返回nil，同时不再做任何其它的操作了。如果source和destination是同一个键，则相当于原子性的将其关联链表中的尾部元素移到该链表的头部。

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

BRPOP key timeout：移出并获取列表的最后一个元素，如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止，假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。反之，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的 key ，第二个元素是被弹出元素的值。

Brpoplpush key1 key2 timeout：命令从列表中取出最后一个元素，并插入到另外一个列表的头部；如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止，假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。反之，返回一个含有两个元素的列表，第一个元素是被弹出元素的值，第二个元素是等待时长。

3.命令使用

127.0.0.1:6379> lpush list1 1 1 1
(integer) 3
127.0.0.1:6379> lrange list1 0 3
1) "1"
2) "1"
3) "1"
//list2 不存在插入失败
127.0.0.1:6379> lpushx list2 1
(integer) 0
127.0.0.1:6379> lrange list2 0 -1
(empty list or set)
127.0.0.1:6379> lpush list1 2
(integer) 4
127.0.0.1:6379> lpop list1
"2"
//删除1个元素是1的
127.0.0.1:6379> lrem list1 1 1
(integer) 1
127.0.0.1:6379> lrange list1 0 -1
1) "1"
2) "1"
//list1 第一个参数3
127.0.0.1:6379> lset list1 0 3
OK
//list1 获取索引是3的值
127.0.0.1:6379> lindex list1 3
(nil)
127.0.0.1:6379> lindex list1 2
(nil)
127.0.0.1:6379> lindex list1 0
"3"
127.0.0.1:6379> lindex list1 1
"1"
127.0.0.1:6379> lrange list1 0 -1
1) "3"
2) "1"
127.0.0.1:6379> llen list1
(integer) 2
127.0.0.1:6379> lpush list1 4
(integer) 3
127.0.0.1:6379> lpush list1 5
(integer) 4
127.0.0.1:6379> lpush list1 6
(integer) 5
127.0.0.1:6379> lrange list1 0 -1
1) "6"
2) "5"
3) "4"
4) "3"
5) "1"
//从左到右list1值为5前插入7
127.0.0.1:6379> linsert list1 before 5 7
(integer) 6
127.0.0.1:6379> lrange list1 0 -1
1) "6"
2) "7"
3) "5"
4) "4"
5) "3"
6) "1"
127.0.0.1:6379> rpush list1 hello
(integer) 7
127.0.0.1:6379> lrange list1 0  -1
1) "6"
2) "7"
3) "5"
4) "4"
5) "3"
6) "1"
7) "hello"
127.0.0.1:6379> ltrim list1 2 5
OK
127.0.0.1:6379> lrange list1 0 -1
1) "5"
2) "4"
3) "3"
4) "1"
127.0.0.1:6379> rpop list1
"1"
127.0.0.1:6379> lrange list 0 -1
(empty list or set)
127.0.0.1:6379> lrange list1 0 -1
1) "5"
2) "4"
3) "3"
127.0.0.1:6379> rpoplpush list1 list2
"3"
127.0.0.1:6379> lrange list1 0 -1
1) "5"
2) "4"
127.0.0.1:6379> lrange list2 0 -1
1) "3"
//移出并获取列表的第一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
127.0.0.1:6379> blpop list1 100
1) "list1"
2) "5"
127.0.0.1:6379> blpop list1 100
1) "list1"
2) "4"
127.0.0.1:6379> blpop list1 100
1) "list1"
2) "2"
(78.34s)
//从列表中弹出一个值，将弹出的元素插入到另外一个列表中并返回它； 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止
127.0.0.1:6379> brpoplpush list1 list2 100
"2"
(2.82s)
127.0.0.1:6379> rpush list1 10
(integer) 1
127.0.0.1:6379> lrange list1 0 -1
1) "10"
//键名list2 存在
127.0.0.1:6379> rpushx list2 3 4 5
(integer) 5
//键名list3 不存在
127.0.0.1:6379> rpushx list3 3
(integer) 0
//移出并获取列表的最后一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
127.0.0.1:6379> brpop list1 100
1) "list1"
2) "3"
(6.58s)