Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【JavaScript ECMAScript】TypedArray::TypedArray.prototype.withインスタンスメソッドの使い方

TypedArray.prototype.with()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

TypedArray.prototype.with()メソッドは、TypedArray(型付き配列)の特定のインデックスにある要素を、新しい値で置き換えた新しいTypedArrayを生成して返すメソッドです。このメソッドの大きな特徴は、元のTypedArrayインスタンスを直接変更しない「非破壊的」な操作である点です。

具体的には、このメソッドは2つの引数を受け取ります。最初の引数は置き換えたい要素のインデックスで、0から始まる整数を指定します。負の数を指定することも可能で、その場合は配列の末尾からの相対的な位置を示します(例:-1は最後の要素、-2は最後から2番目の要素)。2番目の引数は、指定したインデックスに設定する新しい値です。

TypedArrayは、Int8ArrayFloat32Arrayなどのように、特定の数値型に特化したデータを効率的に扱うためのJavaScriptの特殊な配列オブジェクトです。これらの数値データの配列において、一部の要素だけを更新しつつ、元のデータセットの整合性を保ちたい場合にwith()メソッドは非常に有用です。

このメソッドを使うことで、元の配列が意図せず変更されてしまうリスクを避けながら、必要な部分だけを更新した新しい状態の配列を安全に作成できます。これにより、データの不変性(イミュータビリティ)を保ちやすくなり、特に大規模なアプリケーションや並行処理が関わる場面で、プログラムの予測可能性を高め、バグの発生を抑制することに貢献します。

公式リファレンス: TypedArray.prototype.with()

構文(syntax)

1const typedArray = new Int32Array([1, 2, 3, 4, 5]);
2const newTypedArray = typedArray.with(2, 99); // インデックス2の要素を99に置き換えた新しいTypedArrayを生成

引数(parameters)

index, value

  • index: number: 値を変更したい配列の要素のインデックス(位置)を指定する数値
  • value: number: 指定したインデックスに設定する新しい値

戻り値(return)

TypedArray

指定されたインデックスにある要素を、指定された値に置き換えた新しいTypedArrayを返します。元のTypedArrayは変更されません。

関連コンテンツ

関連プログラミング言語