RPUSH key value [value …]

可用版本: >= 1.0.0
时间复杂度: O(1)

将一个或多个值 value 插入到列表 key 的表尾(最右边)。

如果有多个 value 值,那么各个 value 值按从左到右的顺序依次插入到表尾:比如对一个空列表 mylist 执行 RPUSH mylist a b c ,得出的结果列表为 a b c ,等同于执行命令 RPUSH mylist aRPUSH mylist bRPUSH mylist c

如果 key 不存在,一个空列表会被创建并执行 RPUSH 操作。

key 存在但不是列表类型时,返回一个错误。

Note

在 Redis 2.4 版本以前的 RPUSH 命令,都只接受单个 value 值。

返回值

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

代码示例

  1. # 添加单个元素
  2.  
  3. redis> RPUSH languages c
  4. (integer) 1
  5.  
  6.  
  7. # 添加重复元素
  8.  
  9. redis> RPUSH languages c
  10. (integer) 2
  11.  
  12. redis> LRANGE languages 0 -1 # 列表允许重复元素
  13. 1) "c"
  14. 2) "c"
  15.  
  16.  
  17. # 添加多个元素
  18.  
  19. redis> RPUSH mylist a b c
  20. (integer) 3
  21.  
  22. redis> LRANGE mylist 0 -1
  23. 1) "a"
  24. 2) "b"
  25. 3) "c"