10. GETRANGE

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

GETRANGE key start end

可用版本: >= 2.4.0

时间复杂度: O(N),其中 N 为被返回的字符串的长度。

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

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

Note

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

返回值

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

代码示例

redis> SET greeting "hello, my friend"
OK

redis> GETRANGE greeting 0 4          # 返回索引0-4的字符,包括4。
"hello"

redis> GETRANGE greeting -1 -5        # 不支持回绕操作
""

redis> GETRANGE greeting -3 -1        # 负数索引
"end"

redis> GETRANGE greeting 0 -1         # 从第一个到最后一个
"hello, my friend"

redis> GETRANGE greeting 0 1008611    # 值域范围不超过实际字符串,超过部分自动被符略
"hello, my friend"
下一节:为键 key 储存的数字值加上一。