LSET key index value

可用版本: >= 1.0.0
时间复杂度:对头元素或尾元素进行 LSET 操作,复杂度为 O(1)。其他情况下,为 O(N), N 为列表的长度。

将列表 key 下标为 index 的元素的值设置为 value

index 参数超出范围,或对一个空列表( key 不存在)进行 LSET 时,返回一个错误。

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

返回值

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

代码示例

  1. # 对空列表(key 不存在)进行 LSET
  2.  
  3. redis> EXISTS list
  4. (integer) 0
  5.  
  6. redis> LSET list 0 item
  7. (error) ERR no such key
  8.  
  9.  
  10. # 对非空列表进行 LSET
  11.  
  12. redis> LPUSH job "cook food"
  13. (integer) 1
  14.  
  15. redis> LRANGE job 0 0
  16. 1) "cook food"
  17.  
  18. redis> LSET job 0 "play game"
  19. OK
  20.  
  21. redis> LRANGE job 0 0
  22. 1) "play game"
  23.  
  24.  
  25. # index 超出范围
  26.  
  27. redis> LLEN list # 列表长度为 1
  28. (integer) 1
  29.  
  30. redis> LSET list 3 'out of range'
  31. (error) ERR index out of range