2.4 针对列表类型变量的命令

2.4.1 读写列表的命令

• LPUSH:

  • 语法:LPUSH key element [element ...]

  • 功能:将1个或多个值依次插入列表头部.其中key指定待插入的列表,element表示插入到列表的值.返回值为插入操作后的列表长度.

• LINDEX:

  • 语法:LINDEX key index

  • 功能:读取列表的值.其中key指定待读取的列表,index指定列表值的索引号.注意索引号是从0开始的.若key或index不存在则返回nil.

例:

插入列表操作:

查看LIST:

127.0.0.1:6379> LRANGE 001 0 -1
(empty array)

可以看到,此时key为001的list是不存在的

向list的头部插入一个元素:

127.0.0.1:6379> LPUSH 001 "dataTeam"
(integer) 1

再向list的头部插入一个:

127.0.0.1:6379> LPUSH 001 15000
(integer) 2

再向list的头部插入一个:

127.0.0.1:6379> LPUSH 001 'Peter'
(integer) 3

查看list中索引为0的元素的值:

127.0.0.1:6379> LINDEX 001 0
"Peter"

查看list中索引为1的元素的值:

127.0.0.1:6379> LINDEX 001 1
"15000"

查看list中索引为2的元素的值:

127.0.0.1:6379> LINDEX 001 2
"dataTeam"

LINDEX指令不指定索引则报错:

127.0.0.1:6379> LINDEX 001
(error) ERR wrong number of arguments for 'lindex' command

LPUSH指令一次设置多个元素:

127.0.0.1:6379> LPUSH 002 'dataTeam' 12000 'Mary'
(integer) 3

查看list中索引为1的元素的值:

127.0.0.1:6379> LINDEX 002 1
"12000"

• RPUSH:

  • 语法:RPUSH key element [element ...]

  • 功能:将1个或多个值依次插入到列表尾部.其中key指定待插入的列表,element表示插入到列表的值.返回值为插入操作后的列表长度.

例:

一次向list尾部插入多个元素:

127.0.0.1:6379> RPUSH 003 'Tim' 20000 'Hr Team'
(integer) 3

获取list中索引为0的元素的值:

127.0.0.1:6379> LINDEX 003 0
"Tim"

获取list中索引为1的元素的值:

127.0.0.1:6379> LINDEX 003 1
"20000"

获取list中索引为2的元素的值:

127.0.0.1:6379> LINDEX 003 2
"Hr Team"

获取list中不存在的索引:

127.0.0.1:6379> LINDEX 003 3
(nil)

2.4.2 lpushx和rpushx命令

• LPUSHX

  • 语法:LPUSHX key element [element ...]

  • 功能:仅当key存在时向头部插入数据.返回值为插入操作后的列表长度.可以认为返回0则表示插入操作没有执行.

• RPUSHX:

  • 语法:RPUSHX key element [element ...]

  • 功能:仅当key存在时向尾部插入数据.返回值为插入操作后的列表长度.可以认为返回0则表示插入操作没有执行.

例:

删除key为003的list:

127.0.0.1:6379> DEL 003
(integer) 1

当key存在时向头部插入:

127.0.0.1:6379> LPUSHX 003 'dataTeam'
(integer) 0

向头部插入:

127.0.0.1:6379> LPUSH 003 'dataTeam'
(integer) 1

当key存在时向头部插入:

127.0.0.1:6379> LPUSHX 003 10000
(integer) 2

查看索引为1的元素的值:

127.0.0.1:6379> LINDEX 003 1
"dataTeam"

删除key为004的list:

127.0.0.1:6379> DEL 004
(integer) 0

当key存在时向尾部插入:

127.0.0.1:6379> RPUSHX 004 'Tim'
(integer) 0

向尾部插入:

127.0.0.1:6379> RPUSH 004 'Tim'
(integer) 1

当key存在时向尾部插入:

127.0.0.1:6379> RPUSHX 004 15000
(integer) 2

查看索引为1的元素的值:

127.0.0.1:6379> LINDEX 004 1
"15000"

2.4.3 用list模拟堆栈和队列

• LPOP:

  • 语法:LPOP key

  • 功能:从list头部弹出元素.若list中没有元素,则返回nil

• RPOP:

  • 语法:RPOP key

  • 功能:从list尾部弹出元素.若list中没有元素,则返回nil

例:使用LPUSH和LPOP命令模拟一个栈:

模拟入栈:

127.0.0.1:6379> LPUSH myStack 1
(integer) 1
127.0.0.1:6379> LPUSH myStack 2
(integer) 2
127.0.0.1:6379> LPUSH myStack 3
(integer) 3

模拟出栈:

127.0.0.1:6379> LPOP myStack
"3"
127.0.0.1:6379> LPOP myStack
"2"
127.0.0.1:6379> LPOP myStack
"1"

可以看到,模拟了栈的先入后出的特性

对一个没有元素的list使用LPOP:

127.0.0.1:6379> LPOP myStack
(nil)

例:使用LPUSH和RPOP命令模拟一个队列:

模拟入队:

127.0.0.1:6379> LPUSH myQueue 1
(integer) 1
127.0.0.1:6379> LPUSH myQueue 2
(integer) 2
127.0.0.1:6379> LPUSH myQueue 3
(integer) 3

模拟出队:

127.0.0.1:6379> RPOP myQueue
"1"
127.0.0.1:6379> RPOP myQueue
"2"
127.0.0.1:6379> RPOP myQueue
"3"

可以看到,模拟了队列的先入先出的特性

对一个没有元素的list使用RPOP:

127.0.0.1:6379> RPOP myQueue
(nil)

2.4.4 用lrange命令获取指定区间内的数据

• LRANGE:

  • 语法:LRANGE key start stop

  • 功能:获取key对应的list中指定区间内的数据.其中:

    • start:开始的索引

    • stop:结束的索引

    • 包含start位置和stop位置的元素

例:

删除list:

127.0.0.1:6379> DEL 003
(integer) 1

从尾部插入3个元素:

127.0.0.1:6379> RPUSH 003 'dataTeam' 15000 'Mary'
(integer) 3

获取从第0个索引到第1个索引的元素:

127.0.0.1:6379> LRANGE 003 0 1
1) "dataTeam"
2) "15000"

获取从第0个索引到第2个索引的元素:

127.0.0.1:6379> LRANGE 003 0 2
1) "dataTeam"
2) "15000"
3) "Mary"

获取从第0个索引到第4个索引的元素:

127.0.0.1:6379> LRANGE 003 0 4
1) "dataTeam"
2) "15000"
3) "Mary"

可以看到,此时由于list中只有3个元素,故只返回了3个元素的值.

start的索引值大于stop的索引值时:

127.0.0.1:6379> LRANGE 003 4 0
(empty array)

可以看到,当start的索引值大于stop的索引值时,返回值为empty array

2.4.5 用lset命令修改列表数据

• LSET:

  • 语法:LSET key index element

  • 功能:将key对应的list中指定index位置上的元素修改为element.若指定的key不存在,则报错key不存在;若index在list中不存在,则报错索引越界.

例:

删除list:

127.0.0.1:6379> DEL 003
(integer) 1

从list尾部插入元素:

127.0.0.1:6379> RPUSH 003 "Mike" 15000
(integer) 2

查看索引为1的元素:

127.0.0.1:6379> LINDEX 003 1
"15000"

修改索引为1的元素值:

127.0.0.1:6379> LSET 003 1 18000
OK

查看修改结果:

127.0.0.1:6379> LINDEX 003 1
"18000"

查看键名为003的List中的所有元素:

127.0.0.1:6379> LRANGE 003 0 -1
1) "Mike"
2) "18000"

可以看到,此时List中仅有2个元素

对List中一个不存在的索引修改元素值:

127.0.0.1:6379> LSET 003 5 20000
(error) ERR index out of range

可以看到,报错索引越界

对一个不存在的List修改其索引对应的元素值:

127.0.0.1:6379> LSET 005 1 12000
(error) ERR no such key

可以看到,对一个不存在的List修改其索引对应的元素值将报错key不存在

2.4.6 删除列表数据的命令

• LPOP

  • 语法:LPOP key [count]

  • 功能:返回并删除key对应的List头部的前count个元素.若list中没有元素或key对应的list不存在,则返回nil

• RPOP

  • 语法: RPOP key [count]

  • 功能:返回并删除key对应的List尾部的后count个元素.若list中没有元素或key对应的list不存在,则返回nil

例:

删除key对应的list:

127.0.0.1:6379> DEL 003
(integer) 1

从list尾部插入元素:

127.0.0.1:6379> RPUSH 003 "Mike" 15000 "dataTeam" "male"
(integer) 4

删除list头部的2个元素:

127.0.0.1:6379> LPOP 003 2
1) "Mike"
2) "15000"

查看删除后的结果:

127.0.0.1:6379> LRANGE 003 0 -1
1) "dataTeam"
2) "male"

删除list尾部的元素:

127.0.0.1:6379> RPOP 003
"male"
127.0.0.1:6379> RPOP 003
"dataTeam"

127.0.0.1:6379> RPOP 003
(nil)

可以看到,当list中没有元素时,执行删除操作的返回值为nil

查看删除后的结果:

127.0.0.1:6379> LRANGE 003 0 -1
1) "dataTeam"

对一个不存在的key使用删除元素操作:

127.0.0.1:6379> DEL 010
(integer) 0

127.0.0.1:6379> LPOP 010
(nil)
127.0.0.1:6379> RPOP 010 2
(nil)

可以看到,对一个不存在的key使用删除元素操作时,将返回nil

• LREM

  • 语法:LREM key count element.其中:

    • key:指向待删除的list

    • count:

      • count > 0时:从头到尾方向删除,删除数量为count个、值为element的元素

      • count < 0时:从尾到头方向删除,删除数量为count个、值为element的元素

      • count = 0时:删除列表中所有值为element的元素

例:

删除list:

127.0.0.1:6379> DEL 001
(integer) 1

创建list:

127.0.0.1:6379> LPUSH 001 1 1 2 2 1
(integer) 5

删除list中所有值为1的元素:

127.0.0.1:6379> LREM 001 0 1
(integer) 3

查看删除元素后的list:

127.0.0.1:6379> LRANGE 001 0 -1
1) "2"
2) "2"

删除并重新创建list:

127.0.0.1:6379> DEL 001
(integer) 1
127.0.0.1:6379> LPUSH 001 1 1 2 2 1
(integer) 5

从头到尾方向删除2个值为1的元素:

127.0.0.1:6379> LREM 001 2 1
(integer) 2

查看删除结果:

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

删除并重新创建list:

127.0.0.1:6379> DEL 001
(integer) 1
127.0.0.1:6379> LPUSH 001 1 1 2 2 1
(integer) 5

从尾到头方向删除2个值为1的元素:

127.0.0.1:6379> LREM 001 -2 1
(integer) 2

查看删除结果:

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