TypedArray.prototype.fill()

概要

fill()メソッドは、typed array中の開始インデックスから終了インデックスまでの全ての要素を固定値で設定します。このメソッドのアルゴリズムはArray.prototype.fill()と同じです。ここで、TypedArrayはtyped array typesのいずれかを指します。

構文

typedarray.fill(value[, start = 0[, end = this.length]])

引数

value

typed arrayを埋める値

start

オプション。開始インデックス。デフォルトは0です。

end

オプション。終了インデックス。デフォルトはthis.lengthです。

説明

設定される要素の範囲は[start, end)です (endは含まれません)。

fill メソッドは最大三つの引数 value、start、end をとります。 start と end はオプションの引数で、デフォルト値はそれぞれ 0 と this オブジェクトの length です。

start が負の値の場合、length+start として扱われます (length は配列の長さ)。end が負の値の場合、length+end として扱われます。

例

new Uint8Array([1, 2, 3]).fill(4);         // Uint8Array [4, 4, 4]
new Uint8Array([1, 2, 3]).fill(4, 1);      // Uint8Array [1, 4, 4]
new Uint8Array([1, 2, 3]).fill(4, 1, 2);   // Uint8Array [1, 4, 3]
new Uint8Array([1, 2, 3]).fill(4, 1, 1);   // Uint8Array [1, 2, 3]
new Uint8Array([1, 2, 3]).fill(4, -3, -2); // Uint8Array [4, 2, 3]

仕様

ブラウザ実装状況

関連情報

• Array.prototype.fill()