SETRANGE

This page documents the preview (v2.21) version. Preview includes features under active development and is for development and testing only. For production, use the stable (v2024.1) version.

Synopsis

SETRANGE key offset value

This command overwrites the string that is associated with the given key with the given value, starting from the given offset.

  • The offset cannot exceed 536870911.
  • If the offset is larger than the length of the specified string, the string will be padded with zeros up to the offset.
  • If the key does not exist, its associated string is an empty string. The resulted new string is constructed with zeros up to the given offset and then appended with the given value.
  • If the key is associated with a non-string value, an error is raised.

Return value

Returns the length of the resulted string after overwriting.

Examples

$ SET yugakey "YugaKey"

"OK"

$ SETRANGE yugakey 4 "Byte"

8

$ GET yugakey

"Yugabyte"

See also

append, get, getrange, getset, incr, incrby, set, strlen