SIMD.%type%.store()

静的なSIMD.%type%.store() メソッドはSIMDデータ型をtyped arrayに設定します。

構文は

SIMD.float32x4.store(tarray, index, value)
SIMD.float32x4.store1(tarray, index, value)
SIMD.float32x4.store2(tarray, index, value)
SIMD.float32x4.store3(tarray, index, value)

SIMD.int32x4.store(tarray, index, value)
SIMD.int32x4.store1(tarray, index, value)
SIMD.int32x4.store2(tarray, index, value)
SIMD.int32x4.store3(tarray, index, value)

SIMD.float64x2.store(tarray, index, value)
SIMD.float64x2.store1(tarray, index, value)

SIMD.int8x16.store(tarray, index, value)
SIMD.int16x8.store(tarray, index, value)

引数

tarray

typed arrayのインスタンス. これは下記のうちの１つです。:

• Int8Array, Uint8Array, Uint8ClampedArray, Int16Array, Uint16Array, Int32Array, Uint32Array, Float32Array, Float64Array または
• SharedInt8Array, SharedUint8Array, SharedUint8ClampedArray, SharedInt16Array, SharedUint16Array, SharedInt32Array, SharedUint32Array, SharedFloat32Array, SharedFloat64Array.

index

typed arrayに設定し始めるインデックスの数値

value

typed arrayに設定するSIMDデータ型のインスタンス

エラースロー

• indexが範囲外でしたら、例えば、SIMD.int32x4.store(tarray, -1, value) または tarrayのサイズより大きい場合、RangeErrorがスローされます。
• tarrayがtyped array型の１つでないなら、例えば、SIMD.int32x4.store(tarray.buffer, 0) (配列バッファが有効ではありません)なら、TypeErrorがスローされます。

戻り値

設定されたvalue(SIMDデータ型)

説明

SIMDのloadメソッドとstore メソッドはtyped arraysと混在します。loadメソッドで、typed arraysをSIMD型に渡すことができ、store,メソッドで、SIMDデータ型はtyped arraysに設定されます。

store()を使用してすべてのレーン値を設定するか、store1()、 store2()、store3()メソッドで１、２、３番目のレーン値のみを設定することができます。

例

次の例では、Int32Arrayに設定されたSIMD.int32x4 data型を使用します。

すべての値を設定する

var tarray = new Int32Array(8);
var value = SIMD.int32x4(1, 2, 3, 4);
SIMD.int32x4.store(tarray, 0, value);
// tarray = Int32Array[1, 2, 3, 4, 0, 0, 0, 0]

var tarray = new Int32Array(8);
var value = SIMD.int32x4(1, 2, 3, 4);
SIMD.int32x4.store(tarray, 2, value);
// tarray = Int32Array[0, 0, 1, 2, 3, 4, 0, 0]

１つの値を設定する

var tarray = new Int32Array(8);
var value = SIMD.int32x4(1, 2, 3, 4);
SIMD.int32x4.store1(tarray, 0, value);
// tarray = Int32Array[1, 0, 0, 0, 0, 0, 0, 0]

var tarray = new Int32Array(8);
var value = SIMD.int32x4(1, 2, 3, 4);
SIMD.int32x4.store1(tarray, 2, value);
// tarray = Int32Array[0, 0, 1, 0, 0, 0, 0, 0]

２つの値を設定する

var tarray = new Int32Array(8);
var value = SIMD.int32x4(1, 2, 3, 4);
SIMD.int32x4.store2(tarray, 0, value);
// tarray = Int32Array[1, 2, 0, 0, 0, 0, 0, 0]

var tarray = new Int32Array(8);
var value = SIMD.int32x4(1, 2, 3, 4);
SIMD.int32x4.store2(tarray, 2, value);
// tarray = Int32Array[0, 0, 1, 2, 0, 0, 0, 0]

３つの値を設定する

var tarray = new Int32Array(8);
var value = SIMD.int32x4(1, 2, 3, 4);
SIMD.int32x4.store3(tarray, 0, value);
// tarray = Int32Array[1, 2, 3, 0, 0, 0, 0, 0]

var tarray = new Int32Array(8);
var value = SIMD.int32x4(1, 2, 3, 4);
SIMD.int32x4.store3(tarray, 2, value);
// tarray = Int32Array[0, 0, 1, 2, 3, 0, 0, 0]

仕様

SIMDはまだ公式規格文書やドラフトでサポートされていません。typed arraysに基づいた標準化作業や互換性実装のために、ecmascript_simd GitHub リポジトリを確かめて下さい。

ブラウザ実装状況

関連情報

• SIMD
• SIMD.%type%.load()