SIMD.%type%.load()

静的なSIMD.%type%.load() メソッドはtyped arrayからロードされたレーン値をもつ新しいSIMDデータ型を生成します。

構文

SIMD.float32x4.load(tarray, index)
SIMD.float32x4.load1(tarray, index)
SIMD.float32x4.load2(tarray, index)
SIMD.float32x4.load3(tarray, index)

SIMD.int32x4.load(tarray, index)
SIMD.int32x4.load1(tarray, index)
SIMD.int32x4.load2(tarray, index)
SIMD.int32x4.load3(tarray, index)

SIMD.float64x2.load(tarray, index)
SIMD.float64x2.load1(tarray, index)

SIMD.int8x16.load(tarray, index)
SIMD.int16x8.load(tarray, index)

引数

tarray

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

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

index

typed array内でロードを開始するインデックス値

エラースロー

• indexが範囲外なら、例えば、SIMD.int32x4.load(tarray, -1) または tarrayのサイズより大きい値の場合、RangeErrorがスローされます。
• tarrayがtyped arrayの型の１つではない場合、例えば、SIMD.int32x4.load(tarray.buffer, 0) (array bufferが有効ではない)、TypeErrorがスローされます。

説明

SIMDのloadメソッド と storeメソッドはtyped arraysと混在します。 loadメソッドでは、typed arrays内にSIMD型を渡します。store,メソッドでは、 SIMDデータはtyped arraysに格納されます。

load()を使用してすべてのレーン値をロードするか、load1()、load2() または load3()メソッドで１つ、２つ、３つのレーン値のみロードできます。

例

次の例では、SIMD.int32x4データ型にロードされたInt32Arrayを使用します。

すべての値をロードする

var a = new Int32Array([1,2,3,4,5,6,7,8]);
SIMD.int32x4.load(a, 0);
// int32x4[1,2,3,4]

var b = new Int32Array([1,2,3,4,5,6,7,8]);
SIMD.int32x4.load(a, 2);
// int32x4[3,4,5,6]

１つの値をロードする

var a = new Int32Array([1,2,3,4,5,6,7,8]);
SIMD.int32x4.load1(a, 0);
// int32x4[1,0,0,0]

var b = new Int32Array([1,2,3,4,5,6,7,8]);
SIMD.int32x4.load1(a, 2);
// int32x4[3,0,0,0]

２つの値をロードする

var a = new Int32Array([1,2,3,4,5,6,7,8]);
SIMD.int32x4.load2(a, 0);
// int32x4[1,2,0,0]

var b = new Int32Array([1,2,3,4,5,6,7,8]);
SIMD.int32x4.load2(a, 2);
// int32x4[3,4,0,0]

３つの値をロードする

var a = new Int32Array([1,2,3,4,5,6,7,8]);
SIMD.int32x4.load3(a, 0);
// int32x4[1,2,3,0]

var b = new Int32Array([1,2,3,4,5,6,7,8]);
SIMD.int32x4.load3(a, 2);
// int32x4[3,4,5,0]

仕様

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

ブラウザ実装状況

関連情報

• SIMD
• SIMD.%type%.store()