SUBSTR

从字符串值返回子字符串。

语法

SUBSTR key start end

引入版本：1.0.0

复杂度摘要：O(N)

返回存储在 key 的字符串值的子字符串，由偏移量 start 和 end（两者都包含在内）确定。可以使用负偏移量来提供从字符串末尾开始的偏移量。例如，-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	说明
❌ 标准 ❌主动-主动	❌ 标准 ❌主动-主动	自 Redis v2.0.0 起已弃用。

返回值

RESP2

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

RESP3

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

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