SIMD.%type%.select()

静的なSIMD.%type%.select() メソッドはセレクタマスクから選択マッチになるレーン値をもつ新しい対応するSIMDデータ型を生成します。

構文

SIMD.float32x4.select(mask, trueValue, falseValue)
SIMD.float64x2.select(mask, trueValue, falseValue)
SIMD.int8x16.select(mask, trueValue, falseValue)
SIMD.int16x8.select(mask, trueValue, falseValue)
SIMD.int32x4.select(mask, trueValue, falseValue)

引数

mask

セレクタマスクとして使用されるint32x4、 int16x8、int8x16

trueValue

セレクタマスクレーン値がtrueなら、この引数から対応するレーン値を選びます。

falseValue

セレクタマスクレーン値がfalseなら、この引数から対応するレーン値を選びます。

説明

SIMD.%type%.select() メソッドは選択マスクからレーン値を選びます。レーン値をマスキングする(または "ブランチする")ことは、SIMDデータ型において関数上で操作できないので役に立ちます。しかし、マスクとselect関数で、必要な結果のベクトルを組み立てるためにベクトルをブランチしたりマージしたりしてください。

例

カスタム選択マスク

この例では、カスタム選択マスクを生成するためにint32x4.bool() 関数を使います。このマスクで、最初のfloat32x4データ型から最初と最後のレーン値を選ぶことができます。このようにして、select 関数はベクトルaから最初と最後のレーンを、ベクトルbから第２と第３のレーンを選びます。(または、２番目のselectではsumベクトルから)。

var a = SIMD.float32x4(1, 2, 3, 4);
var b = SIMD.float32x4(5, 6, 7, 8);

var mask = SIMD.int32x4.bool(true, false, false, true);

SIMD.float32x4.select(mask, a, b);
// float32x4[1, 6, 7, 4]

var sum = SIMD.float32x4.add(a,b);
SIMD.float32x4.select(mask, a, sum);
// float32x4[1, 8, 10, 4]

選択マスクを返す操作

すべてのSIMD comparison operations は、比較の結果を実際に得るために、selectをしなければならない選択マスクを返します。:

var a = SIMD.float32x4(0, 12, 3, 4);
var b = SIMD.float32x4(0, 6, 7, 50);

var mask = SIMD.float32x4.lessThan(a,b);
// int32x4[0, 0, -1, -1]

var result = SIMD.float32x4.select(mask, a, b);
// float32x4[0, 6, 3, 4]

仕様

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

ブラウザ実装状況

関連情報

• SIMD
• SIMD.%type%.select()