Ruby 3.3 リファレンスマニュアル > ライブラリ一覧 > 組み込みライブラリ > Stringクラス > bytesplice

instance method String#bytesplice

bytesplice(index, length, str) -> String[permalink][rdoc]

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