LTRIM key start stop

    举个例子,执行命令 LTRIM list 0 2 ,表示只保留列表 list 的前三个元素,其余元素全部删除。

    下标(index)参数 startstop 都以 0 为底,也就是说,以 0 表示列表的第一个元素,以 1 表示列表的第二个元素,以此类推。

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

    LTRIM 命令通常和 命令或 RPUSH key value [value …] 命令配合使用,举个例子:

    这个例子模拟了一个日志程序,每次将最新日志 newest_log 放到 log 列表中,并且只保留最新的 100 项。注意当这样使用 LTRIM 命令时,时间复杂度是O(1),因为平均情况下,每次只有一个元素被移除。

    假如你有一个包含一百个元素的列表 list ,对该列表执行 LTRIM list 0 10 ,结果是一个包含11个元素的列表,这表明 stop 下标也在 命令的取值范围之内(闭区间),这和某些语言的区间函数可能不一致,比如Ruby的 Range.newArray#slice 和Python的 函数。

    如果 start 下标比列表的最大下标 end ( LLEN list 减去 1 )还要大,或者 start > stopLTRIM 返回一个空列表(因为 已经将整个列表清空)。

    如果 stop 下标比 end 下标还要大,Redis将 stop 的值设置为 end

    命令执行成功时,返回 。

    1. # 情况 1: 常见情况, start 和 stop 都在列表的索引范围之内
    2.  
    3. redis> LRANGE alpha 0 -1 # alpha 是一个包含 5 个字符串的列表
    4. 1) "h"
    5. 2) "e"
    6. 3) "l"
    7. 4) "l"
    8. 5) "o"
    9.  
    10. redis> LTRIM alpha 1 -1 # 删除 alpha 列表索引为 0 的元素
    11. OK
    12.  
    13. redis> LRANGE alpha 0 -1 # "h" 被删除了
    14. 1) "e"
    15. 2) "l"
    16. 4) "o"
    17.  
    18.  
    19. # 情况 2: stop 比列表的最大下标还要大
    20.  
    21.  
    22. redis> LTRIM alpha 1 10086 # 保留 alpha 列表索引 1 至索引 10086 上的元素
    23. OK
    24.  
    25. redis> LRANGE alpha 0 -1 # 只有索引 0 上的元素 "e" 被删除了,其他元素还在
    26. 1) "l"
    27. 2) "l"
    28. 3) "o"
    29.  
    30.  
    31. # 情况 3: start 和 stop 都比列表的最大下标要大,并且 start < stop
    32.  
    33. redis> LTRIM alpha 10086 123321
    34. OK
    35. redis> LRANGE alpha 0 -1 # 列表被清空
    36. (empty list or set)
    37.  
    38.  
    39. # 情况 4: start 和 stop 都比列表的最大下标要大,并且 start > stop
    40.  
    41. redis> RPUSH new-alpha "h" "e" "l" "l" "o" # 重新建立一个新列表
    42. (integer) 5
    43.  
    44. redis> LRANGE new-alpha 0 -1
    45. 1) "h"
    46. 2) "e"
    47. 3) "l"
    48. 4) "l"
    49. 5) "o"
    50.  
    51. redis> LTRIM new-alpha 123321 10086 # 执行 LTRIM
    52. OK
    53.  
    54. (empty list or set)