SUBSTR key start end
Available since: 1.0.0
Time complexity: O(N) where N is the length of the returned string. The complexity is ultimately determined by the returned length, but because creating a substring from an existing string is very cheap, it can be considered O(1) for small strings.
ACL categories:
@read
@string
@slow
As of Redis version 2.0.0, this command is regarded as deprecated.
It can be replaced by GETRANGE
when migrating or writing new code.
Returns the substring of the string value stored at key
, determined by the
offsets start
and end
(both are inclusive).
Negative offsets can be used in order to provide an offset starting from the end
of the string.
So -1 means the last character, -2 the penultimate and so forth.
The function handles out of range requests by limiting the resulting range to the actual length of the string.
@return
@bulk-string-reply
@examples
redis> SET mykey "This is a string"
TBD
redis> GETRANGE mykey 0 3
TBD
redis> GETRANGE mykey -3 -1
TBD
redis> GETRANGE mykey 0 -1
TBD
redis> GETRANGE mykey 10 100