下記を引数として、置換処理を実行します。
- 置換元の開始インデックス
- 置換元の文字数
- 置換先文字列
第一引数に「置換元の文字列」を、第二引数に下記要素値を持つ配列を指定して、置換跡の文字列を返します。
- index=0 の要素値: 置換元の開始インデックス (Number 型)
- index=1 の要素値: 置換元の文字数 (Number 型)
- index=2 の要素値: 置換先文字列 (String 型)
replaceByIndex('Hello, World!', [7, 5, 'JavaScript']); // "Hello, JavaScript!"第二引数以降は可変引数です。 第三引数以降に「第二引数と同じ構造を持つ配列」を指定する事で複数の置換を一括処理できます。
replaceByIndex('ABC', [0, 1, 'AAA'], [1, 1, 'BBB'], [2, 1, 'CCC']); // "AAABBBCCC"可変引数の順番は自由です。 インデックスの若い順に並べる必要はありません。
replaceByIndex('ABC', [2, 1, 'CCC'], [1, 1, 'BBB'], [0, 1, 'AAA']); // "AAABBBCCC"可変引数では、他と重複した範囲を指定することは出来ません。
replaceByIndex('AB', [0, 1, 'AAA'], [0, 2, 'BBBBBB']); // RangeError: The range of firstIndex and lastIndex must not overlap with other ranges: 0-12 and 7-12この場合は、"AAA" の置換処理を無視し、"BBBBBB" の置換処理だけ実行すれば良いのですが、置換対象範囲が部分的に重複しているケースがあります。
replaceByIndex('AABB', [0, 2, 'AAA'], [1, 3, 'BBBBBB']); // RangeError: The range of firstIndex and lastIndex must not overlap with other ranges: 0-2 and 1-4置換対象("AA"の半分だけ重複しており、置換先文字列("AAA")の半分、つまり、「"A" の1.5文字分」に置換することは不可能な為、重複範囲がある場合には置換できない仕様としました。
「置換元の文字列長」と「置換先の文字列長」が同値となる固定長文字列を対象とする置換では、置換範囲が重複するケースに対応する事ができます。
- 置換データ:
[0, 6, 'AAAAAA'], [1, 4, 'BBBB'], [2, 2, 'CC'] - 置換前:
"000000" - 置換後:
"ABCCBA"
1:1の対応関係で置換処理が実行されるので、重複範囲の切り出しが実現可能になります。 本関数では可変文字列で置換可能な設計とした為、上記仕様は採用できませんでした。