Redis列表(List)
Redis列表是簡單的字符串列表,按照插入順序排序。你可以添加一個元素到列表的頭部(左邊)或者尾部(右邊)
一個列表最多可以包含 \(2^{32} - 1\) 個元素 (4294967295, 每個列表超過40億個元素)。
實例
redis 127.0.0.1:6379> LPUSH mylist redis (integer) 1 redis 127.0.0.1:6379> LPUSH mylist mongodb (integer) 2 redis 127.0.0.1:6379> LPUSH mylist mysql (integer) 3 redis 127.0.0.1:6379> LRANGE mylist 0 10 1) "mysql" 2) "mongodb" 3) "redis"
在以上實例使用了 LPUSH 將三個值插入了名為 mylist 的列表當中。
Redis List 命令
Lpush & Rpush
Redis Lpush 命令將一個或多個值插入到列表頭部。執行 Lpush 操作後,列表的長度。
如果 列表 不存在,一個空列表會被創建並執行 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"
Redis Rpush 命令用於將一個或多個值插入到列表的尾部(最右邊)。執行 RPUSH 操作後,列表的長度。
如果列表不存在,一個空列表會被創建並執行 RPUSH 操作。 當列表存在但不是列表類型時,返回一個錯誤。
redis 127.0.0.1:6379> RPUSH mylist "hello" (integer) 1 redis 127.0.0.1:6379> RPUSH mylist "foo" (integer) 2 redis 127.0.0.1:6379> RPUSH mylist "bar" (integer) 3 redis 127.0.0.1:6379> LRANGE mylist 0 -1 1) "hello" 2) "foo" 3) "bar"
註意: 以上命令在 Redis 2.4 版本以前的 RPUSH 命令,都只接受單個 value 值。
Lpushx & Rpushx
Redis 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"
Redis Rpushx 命令用於將一個值插入到已存在的列表尾部(最右邊)。如果列表不存在,操作無效。
redis 127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
redis 127.0.0.1:6379> RPUSH mylist "foo"
(integer) 2
redis 127.0.0.1:6379> RPUSHX mylist2 "bar"
(integer) 0
redis 127.0.0.1:6379> LRANGE mylist 0 -1
1) "hello"
2) "foo"
Blpop & Brpop & Brpoplpush
Redis Blpop 命令移出並獲取列表的第一個元素, 如果列表沒有元素會阻塞列表直到等待超時或發現可彈出元素為止。
redis 127.0.0.1:6379> BLPOP list1 100
在以上實例中,操作會被阻塞,如果指定的列表 key list1 存在數據則會返回第一個元素,否則在等待100秒後會返回 nil 。
(nil)
(100.06s)
Redis Brpop 命令移出並獲取列表的最後一個元素, 如果列表沒有元素會阻塞列表直到等待超時或發現可彈出元素為止。
redis 127.0.0.1:6379> BRPOP list1 100
在以上實例中,操作會被阻塞,如果指定的列表 key list1 存在數據則會返回第一個元素,否則在等待100秒後會返回 nil 。
(nil)
(100.06s)
Redis Brpoplpush 命令從列表中彈出一個值,將彈出的元素插入到另外一個列表中並返回它; 假如在指定時間內沒有任何元素被彈出,則返回一個 nil 和等待時長。 反之,返回一個含有兩個元素的列表,第一個元素是被彈出元素的值,第二個元素是等待時長。
# 非空列表
redis> BRPOPLPUSH msg reciver 500
"hello moto" # 彈出元素的值
(3.38s) # 等待時長
redis> LLEN reciver
(integer) 1
redis> LRANGE reciver 0 0
1) "hello moto"
# 空列表
redis> BRPOPLPUSH msg reciver 1
(nil)
(1.34s)
Lpop & Rpop
Redis Lpop 命令用於移除並返回列表的第一個元素。
127.0.0.1:6379> LRANGE list1 0 -1
1) "field1"
2) "myhash"
3) "`list1`"
4) "list1"
5) "0"
6) "bar"
7) "foo"
8) "foo"
127.0.0.1:6379> LPOP list1
"field1"
127.0.0.1:6379> LRANGE list1 0 -1
1) "myhash"
2) "`list1`"
3) "list1"
4) "0"
5) "bar"
6) "foo"
7) "foo"
127.0.0.1:6379>
Redis Rpop 命令用於移除並返回列表的最後一個元素。
127.0.0.1:6379> LRANGE list1 0 -1
1) "myhash"
2) "`list1`"
3) "list1"
4) "0"
5) "bar"
6) "foo"
7) "foo"
127.0.0.1:6379> RPOP list1
"foo"
127.0.0.1:6379> LRANGE list1 0 -1
1) "myhash"
2) "`list1`"
3) "list1"
4) "0"
5) "bar"
6) "foo"
127.0.0.1:6379>
Lindex & Lrange
Redis Lindex 命令用於通過索引獲取列表中的元素。你也可以使用負數下標,以 -1 表示列表的最後一個元素, -2 表示列表的倒數第二個元素,以此類推。
redis 127.0.0.1:6379> LPUSH mylist "World"
(integer) 1
redis 127.0.0.1:6379> LPUSH mylist "Hello"
(integer) 2
redis 127.0.0.1:6379> LINDEX mylist 0
"Hello"
redis 127.0.0.1:6379> LINDEX mylist -1
"World"
redis 127.0.0.1:6379> LINDEX mylist 3 # index不在 mylist 的區間範圍內
(nil)
Redis Lrange 返回列表中指定區間內的元素,區間以偏移量 START 和 END 指定。 其中 0 表示列表的第一個元素, 1 表示列表的第二個元素,以此類推。 你也可以使用負數下標,以 -1 表示列表的最後一個元素, -2 表示列表的倒數第二個元素,以此類推。
(integer) 1
redis> RPUSH mylist "two"
(integer) 2
redis> RPUSH mylist "three"
(integer) 3
redis> LRANGE mylist 0 0
1) "one"
redis> LRANGE mylist -3 2
1) "one"
2) "two"
3) "three"
redis> LRANGE mylist -100 100
1) "one"
2) "two"
3) "three"
redis> LRANGE mylist 5 10
(empty list or set)
redis>
Llen
Redis Llen 命令用於返回列表的長度。 如果列表 key 不存在,則 key 被解釋為一個空列表,返回 0 。 如果 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> LLEN list1
(integer) 2
Linsert & Lset
Redis Linsert 命令用於在列表的元素前或者後插入元素。 當指定元素不存在於列表中時,不執行任何操作。 當列表不存在時,被視為空列表,不執行任何操作。 如果 key 不是列表類型,返回一個錯誤。如果命令執行成功,返回插入操作完成之後,列表的長度。 如果沒有找到指定元素 ,返回 -1 。 如果 key 不存在或為空列表,返回 0 。
127.0.0.1:6379> LRANGE mylist 0 -1
1) "Hello"
2) "World"
127.0.0.1:6379> LINSERT mylist BEFORE "World" "cruel"
(integer) 3
127.0.0.1:6379> LRANGE mylist 0 -1
1) "Hello"
2) "cruel"
3) "World"
127.0.0.1:6379> LINSERT mylist AFTER "Hello" "the"
(integer) 4
127.0.0.1:6379> LRANGE mylist 0 -1
1) "Hello"
2) "the"
3) "cruel"
4) "World"
127.0.0.1:6379>
Redis Lset 通過索引來設置元素的值。
當索引參數超出範圍,或對一個空列表進行 LSET 時,返回一個錯誤。
redis 127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
redis 127.0.0.1:6379> RPUSH mylist "hello"
(integer) 2
redis 127.0.0.1:6379> RPUSH mylist "foo"
(integer) 3
redis 127.0.0.1:6379> RPUSH mylist "hello"
(integer) 4
redis 127.0.0.1:6379> LSET mylist 0 "bar"
OK
redis 127.0.0.1:6379> LRANGE mylist 0 -1
1: "bar"
2) "hello"
3) "foo"
4) "hello"
Lrem & Ltrim
Redis Lrem 根據參數 COUNT 的值,移除列表中與參數 VALUE 相等的元素。
COUNT 的值可以是以下幾種:
- count > 0 : 從表頭開始向表尾搜索,移除與 VALUE 相等的元素,數量為 COUNT 。
- count < 0 : 從表尾開始向表頭搜索,移除與 VALUE 相等的元素,數量為 COUNT 的絕對值。
- count = 0 : 移除表中所有與 VALUE 相等的值。
redis 127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
redis 127.0.0.1:6379> RPUSH mylist "hello"
(integer) 2
redis 127.0.0.1:6379> RPUSH mylist "foo"
(integer) 3
redis 127.0.0.1:6379> RPUSH mylist "hello"
(integer) 4
redis 127.0.0.1:6379> LREM mylist -2 "hello"
(integer) 2
Redis Ltrim 對一個列表進行修剪(trim),就是說,讓列表只保留指定區間內的元素,不在指定區間之內的元素都將被刪除。
redis 127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
redis 127.0.0.1:6379> RPUSH mylist "hello"
(integer) 2
redis 127.0.0.1:6379> RPUSH mylist "foo"
(integer) 3
redis 127.0.0.1:6379> RPUSH mylist "bar"
(integer) 4
redis 127.0.0.1:6379> LTRIM mylist 1 -1
OK
redis 127.0.0.1:6379> LRANGE mylist 0 -1
1) "hello"
2) "foo"
3) "bar"
Redis列表(List)