LTRIM · Redis 中文文檔

# LTRIM **LTRIM key start stop** 對一個列表進行修剪(trim)，就是說，讓列表只保留指定區間內的元素，不在指定區間之內的元素都將被刪除。舉個例子，執行命令 `LTRIM list 0 2` ，表示只保留列表 `list` 的前三個元素，其余元素全部刪除。下標(index)參數 `start` 和 `stop` 都以 `0` 為底，也就是說，以 `0` 表示列表的第一個元素，以 `1` 表示列表的第二個元素，以此類推。你也可以使用負數下標，以 `-1` 表示列表的最后一個元素， `-2` 表示列表的倒數第二個元素，以此類推。當 `key` 不是列表類型時，返回一個錯誤。 [LTRIM](#ltrim) 命令通常和 [_LPUSH_](lpush.html#lpush) 命令或 [_RPUSH_](rpush.html#rpush) 命令配合使用，舉個例子： ``` LPUSH log newest_log LTRIM log 0 99 ``` 這個例子模擬了一個日志程序，每次將最新日志 `newest_log` 放到 `log` 列表中，并且只保留最新的 `100` 項。注意當這樣使用 `LTRIM` 命令時，時間復雜度是O(1)，因為平均情況下，每次只有一個元素被移除。 **注意LTRIM命令和編程語言區間函數的區別** 假如你有一個包含一百個元素的列表 `list` ，對該列表執行 `LTRIM list 0 10` ，結果是一個包含11個元素的列表，這表明 `stop` 下標也在 [LTRIM](#ltrim) 命令的取值范圍之內(閉區間)，這和某些語言的區間函數可能不一致，比如Ruby的 `Range.new` 、 `Array#slice` 和Python的 `range()` 函數。 **超出范圍的下標** 超出范圍的下標值不會引起錯誤。如果 `start` 下標比列表的最大下標 `end` ( `LLEN list` 減去 `1` )還要大，或者 `start > stop` ， [LTRIM](#ltrim) 返回一個空列表(因為 [LTRIM](#ltrim) 已經將整個列表清空)。如果 `stop` 下標比 `end` 下標還要大，Redis將 `stop` 的值設置為 `end` 。 **可用版本：** >= 1.0.0 **時間復雜度:** O(N)， `N` 為被移除的元素的數量。 **返回值:** 命令執行成功時，返回 `ok` 。 ``` # 情況 1：常見情況， start 和 stop 都在列表的索引范圍之內 redis> LRANGE alpha 0 -1 # alpha 是一個包含 5 個字符串的列表 1) "h" 2) "e" 3) "l" 4) "l" 5) "o" redis> LTRIM alpha 1 -1 # 刪除 alpha 列表索引為 0 的元素 OK redis> LRANGE alpha 0 -1 # "h" 被刪除了 1) "e" 2) "l" 3) "l" 4) "o" # 情況 2： stop 比列表的最大下標還要大 redis> LTRIM alpha 1 10086 # 保留 alpha 列表索引 1 至索引 10086 上的元素 OK redis> LRANGE alpha 0 -1 # 只有索引 0 上的元素 "e" 被刪除了，其他元素還在 1) "l" 2) "l" 3) "o" # 情況 3： start 和 stop 都比列表的最大下標要大，并且 start < stop redis> LTRIM alpha 10086 123321 OK redis> LRANGE alpha 0 -1 # 列表被清空 (empty list or set) # 情況 4： start 和 stop 都比列表的最大下標要大，并且 start > stop redis> RPUSH new-alpha "h" "e" "l" "l" "o" # 重新建立一個新列表 (integer) 5 redis> LRANGE new-alpha 0 -1 1) "h" 2) "e" 3) "l" 4) "l" 5) "o" redis> LTRIM new-alpha 123321 10086 # 執行 LTRIM OK redis> LRANGE new-alpha 0 -1 # 同樣被清空 (empty list or set) ```