GETRANGE

返回存储在某个键中的字符串的子字符串。

语法

GETRANGE key start end

引入版本：2.4.0

复杂度摘要：O(N)

返回存储在 key 处的字符串值的子字符串，由开始和结束偏移量确定。两个偏移量都包含在内。

可以使用负偏移量从字符串末尾开始向后计数。例如，-1 是最后一个字符，-2 是倒数第二个字符，依此类推。

该函数通过将结果范围限制为字符串的实际长度来处理超出范围的请求。

必需参数

key

键名称。

start

起始偏移量，从零开始。负值从字符串末尾开始计数。

end

结束偏移，从零开始，包含在内。负值从字符串末尾开始计数。

示例

redis> SET mykey "This is a string"
OK
redis> GETRANGE mykey 0 3
"This"
redis> GETRANGE mykey -3 -1
"ing"
redis> GETRANGE mykey 0 -1
"This is a string"
redis> GETRANGE mykey 10 100
"string"

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 标准 ✅ 主动-主动	✅ 标准 ✅ 主动-主动

返回值

RESP2

批量字符串回复：key处存储的字符串值的子字符串，由偏移量start和end（两者都包含在内）决定。

RESP3

批量字符串回复：key处存储的字符串值的子字符串，由偏移量start和end（两者都包含在内）决定。

资料来源：Redis 官方 GETRANGE 文档；中文内容参考 Redis 文档许可。