Redis列表是简单的字符串列表，按照插入顺序排序。你可以添加一个元素到列表的头部（左边）或者尾部（右边）
一个列表最多可以包含 232 - 1 个元素 (4294967295, 每个列表超过40亿个元素)。
- 实例
127.0.0.1:6379> LPUSH runoobkey redis
(integer) 1
127.0.0.1:6379> LPUSH runoobkey mongodb
(integer) 2
127.0.0.1:6379> LPUSH runoobkey mysql
(integer) 3
127.0.0.1:6379> LRANGE runoobkey 0 10
1) "mysql"
2) "mongodb"
3) "redis"
在以上实例中我们使用了 LPUSH 将三个值插入了名为 runoobkey 的列表当中。
Redis 列表命令
下表列出了列表相关的基本命令：
-
1 Blpop
Redis Blpop 命令移出并获取列表的第一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
# 语法
redis 127.0.0.1:6379> BLPOP LIST1 LIST2 .. LISTN TIMEOUT
# 返回值
如果列表为空，返回一个 nil 。 否则，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的 key ，第二个元素是被弹出元素的值。
# 实例
127.0.0.1:6379> BLPOP list1 10
(nil)
(10.04s)
在以上实例中，操作会被阻塞，如果指定的列表 key list1 存在数据则会返回第一个元素，否则在等待100秒后会返回 nil 。
-
2 Brpop
Redis Brpop 命令移出并获取列表的最后一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
# 语法
redis 127.0.0.1:6379> BRPOP LIST1 LIST2 .. LISTN TIMEOUT
# 返回值
假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。 反之，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的 key ，第二个元素是被弹出元素的值。。
# 实例
127.0.0.1:6379> BRPOP list1 5
(nil)
(5.01s)
在以上实例中，操作会被阻塞，如果指定的列表 key list1 存在数据则会返回第一个元素，否则在等待100秒后会返回 nil 。
-
3 Brpoplpush
Redis Brpoplpush 命令从列表中弹出一个值，将弹出的元素插入到另外一个列表中并返回它； 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
# 语法
redis 127.0.0.1:6379> BRPOPLPUSH LIST1 ANOTHER_LIST TIMEOUT
# 返回值
假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。 反之，返回一个含有两个元素的列表，第一个元素是被弹出元素的值，第二个元素是等待时长。。
# 实例
# 非空列表
127.0.0.1:6379> BRPOPLPUSH runoobkey mylist 5
"redis" # 弹出元素的值
127.0.0.1:6379> llen mylist
(integer) 1
127.0.0.1:6379> lrange mylist
(error) ERR wrong number of arguments for 'lrange' command
127.0.0.1:6379> lrange mylist 0 0
1) "redis"
# 空列表
127.0.0.1:6379> BRPOPLPUSH msg reciver 1
(nil)
(1.03s)
-
4 Lindex
Redis Lindex 命令用于通过索引获取列表中的元素。你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。
# 语法
redis 127.0.0.1:6379> LINDEX KEY_NAME INDEX_POSITION
# 返回值
列表中下标为指定索引值的元素。 如果指定索引值不在列表的区间范围内，返回 nil
# 实例
127.0.0.1:6379> LPUSH mylist "World"
(integer) 1
127.0.0.1:6379> LPUSH mylist "Hello"
(integer) 2
127.0.0.1:6379> LINDEX mylist 0
"Hello"
127.0.0.1:6379> LINDEX mylist -1
"World"
127.0.0.1:6379> LINDEX mylist 3 # index不在 mylist 的区间范围内
(nil)
-
5 Linsert
Redis Linsert 命令用于在列表的元素前或者后插入元素。 当指定元素不存在于列表中时，不执行任何操作。 当列表不存在时，被视为空列表，不执行任何操作。 如果 key 不是列表类型，返回一个错误
# 语法
redis 127.0.0.1:6379> LINSERT KEY_NAME BEFORE EXISTING_VALUE NEW_VALUE
# 返回值
如果命令执行成功，返回插入操作完成之后，列表的长度。 如果没有找到指定元素 ，返回 -1 。 如果 key 不存在或为空列表，返回 0 。
# 实例
127.0.0.1:6379> RPUSH mylist "Hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "World"
(integer) 2
127.0.0.1:6379> LINSERT mylist BEFORE "World" "There"
(integer) 3
127.0.0.1:6379> LRANGE mylist 0 -1
1) "Hello"
2) "There"
3) "World"
-
6 Llen
Redis Llen 命令用于返回列表的长度。 如果列表 key 不存在，则 key 被解释为一个空列表，返回 0 。 如果 key 不是列表类型，返回一个错误。
# 语法
redis 127.0.0.1:6379> LLEN KEY_NAME
# 返回值
列表的长度。
# 实例
127.0.0.1:6379> RPUSH list1 "foo"
(integer) 1
127.0.0.1:6379> RPUSH list1 "bar"
(integer) 2
127.0.0.1:6379> LLEN list1
(integer) 2
-
7 Lpop
Redis Lpop 命令用于移除并返回列表的第一个元素。
# 语法
redis 127.0.0.1:6379> Lpop KEY_NAME
# 返回值
列表的第一个元素。 当列表 key 不存在时，返回 nil 。。
# 实例
首先，我们在 redis 中创建一个 key 并设置值。
# 对不存在的键进行设置
redis 127.0.0.1:6379> RPUSH list1 "foo"
(integer) 1
redis 127.0.0.1:6379> RPUSH list1 "bar"
(integer) 2
redis 127.0.0.1:6379> LPOP list1
"foo"
127.0.0.1:6379> LRANGE list1 0 10
1) "bar"
-
8 Lpush
Redis Lpush 命令将一个或多个值插入到列表头部。 如果 key 不存在，一个空列表会被创建并执行 LPUSH 操作。 当 key 存在但不是列表类型时，返回一个错误。
# 语法
redis 127.0.0.1:6379> LPUSH KEY_NAME VALUE1.. VALUEN
# 返回值
执行 LPUSH 命令后，列表的长度。
# 实例
127.0.0.1:6379> LPUSH list1 "foo"
(integer) 1
127.0.0.1:6379> LPUSH list1 "bar"
(integer) 2
127.0.0.1:6379> LRANGE list1 0 -1
1) "bar"
2) "foo"
-
9 Lpushx
Redis Lpushx 将一个值插入到已存在的列表头部，列表不存在时操作无效。
# 语法
redis 127.0.0.1:6379> LPUSHX KEY_NAME VALUE1.. VALUEN
# 返回值
LPUSHX 命令执行之后，列表的长度。
# 实例
127.0.0.1:6379> LPUSH list1 "foo"
(integer) 1
127.0.0.1:6379> LPUSHX list1 "bar"
(integer) 2
127.0.0.1:6379> LPUSHX list2 "bar"
(integer) 0
127.0.0.1:6379> LRANGE list1 0 -1
1) "bar"
2) "foo"
127.0.0.1:6379> LRANGE list2 0 -1
(empty list or set)
-
10 Lrange
Redis Lrange 返回列表中指定区间内的元素，区间以偏移量 START 和 END 指定。 其中 0 表示列表的第一个元素， 1 表示列表的第二个元素，以此类推。 你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。
# 语法
redis 127.0.0.1:6379> LRANGE KEY_NAME START END
# 返回值
一个列表，包含指定区间内的元素。
# 实例
redis 127.0.0.1:6379> LPUSH list1 "foo"
(integer) 1
redis 127.0.0.1:6379> LPUSH list1 "bar"
(integer) 2
redis 127.0.0.1:6379> LPUSHX list1 "bar"
(integer) 0
redis 127.0.0.1:6379> LRANGE list1 0 -1
1) "bar"
2) "bar"
3) "foo"
-
11 Lrem
Redis Lrem 根据参数 COUNT 的值，移除列表中与参数 VALUE 相等的元素。
COUNT 的值可以是以下几种：
count > 0 : 从表头开始向表尾搜索，移除与 VALUE 相等的元素，数量为 COUNT 。
count < 0 : 从表尾开始向表头搜索，移除与 VALUE 相等的元素，数量为 COUNT 的绝对值。
count = 0 : 移除表中所有与 VALUE 相等的值。
# 语法
redis 127.0.0.1:6379> LREM KEY_NAME COUNT VALUE
# 返回值
被移除元素的数量。 列表不存在时返回 0 。
# 实例
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 2
127.0.0.1:6379> RPUSH mylist "foo"
(integer) 3
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 4
127.0.0.1:6379> lrange mylist 0 -1
1) "hello"
2) "hello"
3) "foo"
4) "hello"
127.0.0.1:6379> LREM mylist -2 "hello"
(integer) 2
127.0.0.1:6379> lrange mylist 0 -1
1) "hello"
2) "foo"
-
12 Lset
Redis Lset 通过索引来设置元素的值。
当索引参数超出范围，或对一个空列表进行 LSET 时，返回一个错误。
# 语法
redis 127.0.0.1:6379> LSET KEY_NAME INDEX VALUE
# 返回值
操作成功返回 ok ，否则返回错误信息。
# 实例
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 2
127.0.0.1:6379> RPUSH mylist "foo"
(integer) 3
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 4
127.0.0.1:6379> lrange mylist 0 -1
1) "hello"
2) "hello"
3) "foo"
4) "hello"
127.0.0.1:6379> lset mylist 0 666
OK
127.0.0.1:6379> lrange mylist 0 -1
1) "666"
2) "hello"
3) "foo"
4) "hello"
-
13 Ltrim
Redis Ltrim 对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。
下标 0 表示列表的第一个元素，以 1 表示列表的第二个元素，以此类推。 你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。
# 语法
redis 127.0.0.1:6379> LTRIM KEY_NAME START STOP
# 返回值
命令执行成功时，返回 ok 。
# 实例
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "SB"
(integer) 2
127.0.0.1:6379> RPUSH mylist "CTO"
(integer) 3
127.0.0.1:6379> RPUSH mylist "大水货"
(integer) 4
127.0.0.1:6379> lrange mylist 0 -1
1) "hello"
2) "SB"
3) "CTO"
4) "\xe5\xa4\xa7\xe6\xb0\xb4\xe8\xb4\xa7"
127.0.0.1:6379> LTRIM mylist 2 -1
OK
127.0.0.1:6379> lrange mylist 0 -1
1) "CTO"
2) "\xe5\xa4\xa7\xe6\xb0\xb4\xe8\xb4\xa7"
-
14 Rpop
Redis Rpop 命令用于移除并返回列表的最后一个元素。
# 语法
redis 127.0.0.1:6379> RPOP KEY_NAME
# 返回值
列表的最后一个元素。 当列表不存在时，返回 nil 。
# 实例
127.0.0.1:6379> RPUSH mylist "one"
(integer) 1
127.0.0.1:6379> RPUSH mylist "two"
(integer) 2
127.0.0.1:6379> RPUSH mylist "three"
(integer) 3
127.0.0.1:6379> RPOP mylist
"three"
127.0.0.1:6379> lrange mylist 0 -1
1) "one"
2) "two"
-
15 Rpoplpush
Redis Rpoplpush 命令用于移除列表的最后一个元素，并将该元素添加到另一个列表并返回。
# 语法
redis 127.0.0.1:6379> RPOPLPUSH SOURCE_KEY_NAME DESTINATION_KEY_NAME
# 返回值
被弹出的元素。
# 实例
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "foo"
(integer) 2
127.0.0.1:6379> RPUSH mylist "bar"
(integer) 3
127.0.0.1:6379> RPOPLPUSH mylist myotherlist
"bar"
127.0.0.1:6379> LRANGE mylist 0 -1
1) "hello"
2) "foo"
127.0.0.1:6379> LRANGE myotherlist 0 -1
1) "bar"
-
16 Rpush
Redis Rpush 命令用于将一个或多个值插入到列表的尾部(最右边)。
如果列表不存在，一个空列表会被创建并执行 RPUSH 操作。 当列表存在但不是列表类型时，返回一个错误。
注意：在 Redis 2.4 版本以前的 RPUSH 命令，都只接受单个 value 值。。
# 语法
redis 127.0.0.1:6379> RPUSH KEY_NAME VALUE1..VALUEN
# 返回值
执行 RPUSH 操作后，列表的长度。
# 实例
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "foo"
(integer) 2
127.0.0.1:6379> RPUSH mylist "bar"
(integer) 3
127.0.0.1:6379> LRANGE mylist 0 -1
1) "hello"
2) "foo"
3) "bar"
-
17 Rpushx
Redis Rpushx 命令用于将一个值插入到已存在的列表尾部(最右边)。如果列表不存在，操作无效。
# 语法
redis 127.0.0.1:6379> RPUSHX KEY_NAME VALUE1..VALUEN
# 返回值
执行 Rpushx 操作后，列表的长度。
# 实例
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "foo"
(integer) 2
127.0.0.1:6379> RPUSHX mylist2 "bar"
(integer) 0
127.0.0.1:6379> LRANGE mylist 0 -1
1) "hello"
2) "foo"