醉丶春风的Blog

千里之行, 始于足下



redis 列表相关命令


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

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

LPUSH

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

语法

LPUSH KEY_NAME VALUE1.. VALUEN

返回值

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

示例

127.0.0.1:6379> LPUSH list "a"
(integer) 1
127.0.0.1:6379> LPUSH list 'b' 'c'
(integer) 3
127.0.0.1:6379> LRANGE list 0 -1
1) "c"
2) "b"
3) "a"

LPOP

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

语法

redis 127.0.0.1:6379> Lpop KEY_NAME

返回值

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

示例

127.0.0.1:6379> LRANGE list 0 -1
1) "b"
2) "a"
127.0.0.1:6379> LPOP list
"b"

RPUSH

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

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

语法

redis 127.0.0.1:6379> RPUSH KEY_NAME VALUE1..VALUEN

返回值

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

示例

127.0.0.1:6379> RPUSH list 'a-' 'a--'
(integer) 3
127.0.0.1:6379> LRANGE list 0 -1
1) "a"
2) "a-"
3) "a--"

LRANGE

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

START表示从这个元素开始, 一定会返回该元素, END表示从START之后的元素长度,不包括START位置的元素

语法

redis 127.0.0.1:6379> LRANGE KEY_NAME START END

返回值

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

示例

127.0.0.1:6379> LRANGE list 0 -1
1) "a"
2) "a-"
3) "a--"

RPOP

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

语法

redis 127.0.0.1:6379> RPOP KEY_NAME

返回值

被移除的元素。
当列表不存在时,返回 nil 。

示例

127.0.0.1:6379> RPOP list
"a--"

LLEN

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

语法

redis 127.0.0.1:6379> LLEN KEY_NAME

返回值

列表的长度
当列表不存在时,返回 0 。

示例

127.0.0.1:6379> LLEN list
(integer) 2
127.0.0.1:6379> LLEN aaaaaa
(integer) 0

LINDEX

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

语法

redis 127.0.0.1:6379> LINDEX KEY_NAME INDEX_POSITION

返回值

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

示例

127.0.0.1:6379> LINDEX list -1
"a-"
127.0.0.1:6379> LINDEX aaaa -1
(nil)

LPUSHX 和 RPUSHX

和 LPUSH, RPUSH 唯一的区别就是当列表key不存在时不创建列表进行插入

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> LPUSH list hello hello split hello
(integer) 4
127.0.0.1:6379> LRANGE list 0 -1
1) "hello"
2) "split"
3) "hello"
4) "hello"
// 从列表左边开始,查找并内删除值为 'hello'的元素, 删除数量为1个
127.0.0.1:6379> LREM list 1 hello 
(integer) 1
// 从列表右边开始,查找并内删除值为 'hello'的元素, 删除数量为1个
127.0.0.1:6379> LRANGE list 0 -1
1) "split"
2) "hello"
3) "hello"
127.0.0.1:6379> LREM list -1 hello
(integer) 1
127.0.0.1:6379> LRANGE list 0 -1
1) "split"
2) "hello"
127.0.0.1:6379>

LSET

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

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

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

语法

redis 127.0.0.1:6379> LSET KEY_NAME INDEX VALUE

返回值

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

示例

127.0.0.1:6379> LPUSH list 1 2 a 4
(integer) 4
127.0.0.1:6379> LRANGE list 0 -1
1) "4"
2) "a"
3) "2"
4) "1"
127.0.0.1:6379> LSET list 2 'now is 3'
OK
127.0.0.1:6379> LRANGE list 0 -1
1) "4"
2) "a"
3) "now is 3"
4) "1"
127.0.0.1:6379> LSET list 20 'error'
(error) ERR index out of range

LTRIM

类似于其他语言的 split
Redis Ltrim 对一个列表进行修剪(trim),就是说,让列表只保留指定区间内的元素,不在指定区间之内的元素都将被删除。

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

语法

redis 127.0.0.1:6379> LTRIM KEY_NAME START STOP

返回值

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

示例

127.0.0.1:6379> LPUSH list 0 1 2 3 4 5
(integer) 6
127.0.0.1:6379> LRANGE list 0 -1
1) "5"
2) "4"
3) "3"
4) "2"
5) "1"
6) "0"
127.0.0.1:6379> LTRIM list 2 5
OK
127.0.0.1:6379> LRANGE list 0 -1
1) "3"
2) "2"
3) "1"
4) "0"
127.0.0.1:6379>

RPOPLPUSH

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

语法

redis 127.0.0.1:6379> RPOPLPUSH SOURCE_KEY_NAME DESTINATION_KEY_NAME

返回值

被弹出的元素。。

LINSERT

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

语法

redis 127.0.0.1:6379> LINSERT key BEFORE|AFTER pivot value
将值 value 插入到列表 key 当中,位于值 pivot 之前或之后。

返回值

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

示例

127.0.0.1:6379> RPUSH list hello noword 1
(integer) 3
127.0.0.1:6379> LRANGE list 0 -1
1) "hello"
2) "noword"
3) "1"
127.0.0.1:6379> LINSERT list BEFORE noword word
(integer) 4
127.0.0.1:6379> LRANGE list 0 -1
1) "hello"
2) "word"
3) "noword"
4) "1"
127.0.0.1:6379>

BLPOP

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

语法

redis 127.0.0.1:6379> BLPOP LIST1 LIST2 .. LISTN TIMEOUT

返回值

如果列表为空,返回一个 nil 。 否则,返回一个含有两个元素的列表,第一个元素是被弹出元素所属的 key ,第二个元素是被弹出元素的值。

示例

127.0.0.1:6379> BLPOP list1 20
1) "list1"
2) "222"
(7.92s)

在以上实例中,操作会被阻塞,如果指定的列表 key list1 存在数据则会返回第一个元素,否则在等待20秒后会返回 nil 。
另起一个进程, 执行 RPUSH list1 222 则返回该数据

BRPOP

BLPOP 获取列表的最后一个元素

BRPOPLPUSH

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

语法

redis 127.0.0.1:6379> BRPOPLPUSH LIST1 ANOTHER_LIST TIMEOUT

返回值

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


作者: 徐善通
地址: https://xstnet.com/article-104.html
声明: 除非本文有注明出处,否则转载请注明本文地址


我有话说



最新回复


正在加载中....

Copyrights © 2016-2019 醉丶春风 , All rights reserved. 皖ICP备15015582号-1