instance method String#bytesplice

bytesplice(index, length, str) -> String[permalink][rdoc][edit]
bytesplice(index, length, str, str_index, str_length) -> String
bytesplice(range, str) -> String
bytesplice(range, str, str_range) -> String

self の一部または全部を str で置き換えて self を返します。

str_index と str_length もしくは str_range が与えられたとき、self の一部または全部を str.byteslice(str_index, str_length) もしくは str.byteslice(str_range) で置き換えます。ただし、str の部分文字列は新しい文字列オブジェクトとして生成されません。

置き換え範囲の指定は、長さの指定が省略できないこと以外は String#byteslice と同じです。置き換え後の文字列の長さが対象の長さと違う場合、適切に長さが調整されます。

[PARAM] index:
置換したい文字列の範囲の始端
[PARAM] length:
置換したい文字列の範囲の長さ
[PARAM] str_index:
str の範囲の始端
[PARAM] str_length:
str の範囲の長さ
[PARAM] range:
置換したい文字列の範囲を示す Range オブジェクト
[PARAM] str_range:
str の範囲を示す Range オブジェクト
[EXCEPTION] IndexError:
index や length が範囲外の場合に発生
[EXCEPTION] RangeError:
range が範囲外の場合に発生
[EXCEPTION] IndexError:
指定した始端や終端が文字列の境界と一致しない場合に発生

[SEE_ALSO] String#byteslice