GETRANGE key start end

可用版本： >= 2.4.0
时间复杂度： O(N)，其中 N 为被返回的字符串的长度。

返回键 key 储存的字符串值的指定部分，字符串的截取范围由 start 和 end 两个偏移量决定(包括 start 和 end 在内)。

负数偏移量表示从字符串的末尾开始计数，-1 表示最后一个字符，-2 表示倒数第二个字符，以此类推。

GETRANGE 通过保证子字符串的值域(range)不超过实际字符串的值域来处理超出范围的值域请求。

Note

GETRANGE 命令在 Redis 2.0 之前的版本里面被称为 SUBSTR 命令。

返回值

GETRANGE 命令会返回字符串值的指定部分。

代码示例

  1. redis> SET greeting "hello, my friend"
  2. OK
  3.  
  4. redis> GETRANGE greeting 0 4          # 返回索引0-4的字符，包括4。
  5. "hello"
  6.  
  7. redis> GETRANGE greeting -1 -5        # 不支持回绕操作
  8. ""
  9.  
  10. redis> GETRANGE greeting -3 -1        # 负数索引
  11. "end"
  12.  
  13. redis> GETRANGE greeting 0 -1         # 从第一个到最后一个
  14. "hello, my friend"
  15.  
  16. redis> GETRANGE greeting 0 1008611    # 值域范围不超过实际字符串，超过部分自动被符略
  17. "hello, my friend"