5.4.11.3. []=

Returns the receiving buffer with the characters from the nth character for length characters replaced with new. The replacement position and length can extend beyond the end of the receiving string. The starting position, n, is required and must be a positive whole number. The length is optional and must be a positive whole number or zero. If length is omitted, it defaults to the length of new.

If n is greater than the length of the receiving string, blanks are added before the new string.

See also the similar MutableBuffer method replaceAt.

Example 5.264. MutableBuffer class — []= method

s = .MutableBuffer~new(xrange("a", "z"))
s[5] = "E"              -- "abcdEfghijklmnopqrstuvwxyz"
s[5] = "XXXX"           -- "abcdXXXXijklmnopqrstuvwxyz"
s[5] = ""               -- "abcdXXXXijklmnopqrstuvwxyz"
s[5, 1] = "="           -- "abcd=XXXijklmnopqrstuvwxyz"
s[5, 4] = "="           -- "abcd=ijklmnopqrstuvwxyz"
s[10, 2] = "REPLACE"    -- "abcd=ijklREPLACEopqrstuvwxyz"
s[4, 99] = ""           -- "abc"