【Redis学习系列】List类型

List 类型

Redis列表是简单的字符串列表，按照插入顺序排序。你可以添加一个元素到列表的头部（左边）或者尾部（右边）一个列表最多可以包含 232 - 1 个元素 (4294967295, 每个列表超过40亿个元素)。

lpush rpush

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

127.0.0.1:6379> lpush teachers hezm
(integer) 1
127.0.0.1:6379> lpush teachers huzd chengff
(integer) 3
127.0.0.1:6379> lrange teachers 0 -1
1) "chengff"
2) "huzd"
3) "hezm"

rpush命令用于将一个或多个值插入到列表的尾部(最右边)。如果列表不存在，一个空列表会被创建并执行 RPUSH 操作。 当列表存在但不是列表类型时，返回一个错误。

127.0.0.1:6379> rpush teachers dongjj liumm
(integer) 5
127.0.0.1:6379> lrange teachers 0 -1
1) "chengff"
2) "huzd"
3) "hezm"
4) "dongjj"
5) "liumm"

lpushx rpushx

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

127.0.0.1:6379> lpushx teachers liuzz
(integer) 6
127.0.0.1:6379> lpushx teacher dengjj #列表不存在时无效
(integer) 0

Rpushx 将一个或多个值插入到列表的尾部(最右边)。如果列表不存在，一个空列表会被创建并执行 RPUSH 操作。 当列表存在但不是列表类型时，返回一个错误。

127.0.0.1:6379> rpushx tearchers huangcg
(integer) 0
127.0.0.1:6379> rpushx teachers huangcg
(integer) 7
127.0.0.1:6379> lrange teachers 0 -1
1) "liuzz"
2) "chengff"
3) "huzd"
4) "hezm"
5) "dongjj"
6) "liumm"
7) "huangcg"

lpop & rpop

lpop移除列表的第一个元素并返回该元素；rpop移除列表最后一个元素并返回该元素。

127.0.0.1:6379> rpush students huzd     #创建一个列表存入第一个元素
(integer) 1
127.0.0.1:6379> rpush students zhangdd liqq wangmm tianww #再次往列表中存入多个元素
(integer) 5
127.0.0.1:6379> lrange students 0 -1  #查看列表长度
1) "huzd"
2) "zhangdd"
3) "liqq"
4) "wangmm"
5) "tianww"
127.0.0.1:6379> rpop students  #弹出列表最后一个元素，并返回
"tianww"
127.0.0.1:6379> lpop students  #弹出列表第一个元素，并返回
"huzd"

llen 获取长度

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

127.0.0.1:6379> llen students
(integer) 3

lrange 获取区间值

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

127.0.0.1:6379> lpush students huzd chengdd zhangdd lidd wangdd tiandd madd
(integer) 7
127.0.0.1:6379> lrange students -10 100
1) "madd"
2) "tiandd"
3) "wangdd"
4) "lidd"
5) "zhangdd"
6) "chengdd"
7) "huzd"
127.0.0.1:6379> lrange students  10 20
(empty array)
127.0.0.1:6379> lrange students 0 0
1) "madd"

lindex 获取下标元素

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

1) "madd"
2) "tiandd"
3) "wangdd"
4) "lidd"
5) "zhangdd"
6) "chengdd"
7) "huzd"
127.0.0.1:6379> lrange students  10 20
(empty array)
127.0.0.1:6379> lrange students 0 0
1) "madd"
127.0.0.1:6379> lindex students 1
"tiandd"
127.0.0.1:6379> lindex students -2
"chengdd"
127.0.0.1:6379> lindex students 100
(nil)

ltrim

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

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

127.0.0.1:6379> lrange students 0 -1
1) "madd"
2) "tiandd"
3) "wangdd"
4) "lidd"
5) "zhangdd"
6) "chengdd"
7) "huzd"
127.0.0.1:6379> ltrim students 0 -2
OK
127.0.0.1:6379> lrange students 0 -1
1) "madd"
2) "tiandd"
3) "wangdd"
4) "lidd"
5) "zhangdd"
6) "chengdd"

lset

lset 通过索引来设置元素的值。当索引参数超出范围，或对一个空列表进行 LSET 时，返回一个错误。

127.0.0.1:6379> lrange students 0 -1
1) "madd"
2) "tiandd"
3) "wangdd"
4) "lidd"
5) "zhangdd"
6) "chengdd"
127.0.0.1:6379> lset students 0 macc
OK
127.0.0.1:6379> lrange students 0 -1
1) "macc"
2) "tiandd"
3) "wangdd"
4) "lidd"
5) "zhangdd"
6) "chengdd"

lrem

lrem 根据参数 COUNT 的值，移除列表中与参数 VALUE 相等的元素。COUNT 的值可以是以下几种：

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

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

127.0.0.1:6379> lpush st hello foo hello hello world hello
(integer) 6
127.0.0.1:6379> lrem st 0 hello
(integer) 4
127.0.0.1:6379> lrange st 0 -1
1) "world"
2) "foo"

linsert 列表中插入元素

linsert 命令用于在列表的元素前或者后插入元素。当指定元素不存在于列表中时，不执行任何操作。当列表不存在时，被视为空列表，不执行任何操作。如果 key 不是列表类型，返回一个错误。

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

127.0.0.1:6379> lrange st 0 -1
1) "world"
2) "foo"
127.0.0.1:6379> linsert st after foo hello
(integer) 3
127.0.0.1:6379> lrange st 0 -1
1) "world"
2) "foo"
3) "hello"

rpoppush

rpoplpush 命令用于移除列表的最后一个元素，并将该元素添加到另一个列表并返回。返回值：被弹出的元素。

127.0.0.1:6379> lrange st 0 -1
1) "world"
2) "foo"
3) "hello"
127.0.0.1:6379> rpoplpush st st2
"hello"
127.0.0.1:6379> lrange st 0 -1
1) "world"
2) "foo"
127.0.0.1:6379> lrange st2 0 -1
1) "hello"

blpop & brpop

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

客户端1：

127.0.0.1:6379> lrange st2 0 -1  #1 查看st2的值
1) "hello"
127.0.0.1:6379> blpop st2 1000   #2 弹出st2的第一个值；此时st2为空
1) "st2"
2) "hello"
127.0.0.1:6379> blpop st2 100000  #3 继续弹出st2的第一个值，此时st2为空，阻塞列表等待
1) "st2"
2) "1111"
(27.62s)                           #5 执行阻塞弹出加入值及耗时。

客户端2：

127.0.0.1:6379> lpush st2 1111  #4 往st2中加入第一个值
(integer) 1

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

客户端1：

127.0.0.1:6379> rpush st2 111 222 #正常压入两个值
(integer) 2
127.0.0.1:6379> brpop st2 100  #弹出一个值
1) "st2"
2) "222"
#晴空列表
127.0.0.1:6379> brpop st2 100 #1 弹出最后一个字，进入等待
1) "st2"
2) "2222"
(21.54s)										  # 结束等待弹出值

客户端2：

127.0.0.1:6379> rpush st2 2222 #2 压入一个值
(integer) 1

brpoplpush

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

127.0.0.1:6379> lrange st2 0 0 
1) "111"
127.0.0.1:6379> brpoplpush st2 st3 1
"111"
127.0.0.1:6379> LLEN st3
(integer) 1
127.0.0.1:6379> lrange st3 0 -1
1) "111"
127.0.0.1:6379> brpoplpush st2 st3 1
(nil)
(1.04s)