SIMD.%type%.store()

Les méthodes statiques SIMD.%type%.store() permettent d'enregistrer un vecteur SIMD dans un tableau typé.

Syntax

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.Float64x2.store(tarray, index, value)
SIMD.Float64x2.store1(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.Int8x16.store(tarray, index, value)
SIMD.Int16x8.store(tarray, index, value) 

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

SIMD.Uint8x16.store(tarray, index, value)
SIMD.Uint16x8.store(tarray, index, value) 

Paramètres

tarray

Une instance d'un tableau typé. Cela peut être un :

• Int8Array, UInt8Array, UInt8ClampedArray, Int16Array, UInt16Array, Int32Array, UInt32Array, Float32Array, Float64Array

index

L'indice du tableau typé à partir duquel on souhaite enregistrer les données.

valeur

Une instance d'un type SIMD qu'on souhaite enregistrer dans un tableau typé.

Valeur de retour

La valeur qui a été enregistrée (un vecteur SIMD).

Exceptions levées

• Si index est en dehors de l'intervalle valide, par exemple avec SIMD.Int32x4.store(tarray, -1, valeur) ou s'il est supérieur à la taille de tarray, cela provoquera une exception RangeError.
• Si tarray n'est pas une instance d'un des types de tableaux typés, par exemple SIMD.Int32x4.store(tarray.buffer, 0) (un buffer n'est pas accepté ici), cela provoquera une exception TypeError.

Description

Les méthodes SIMD load et store permettent d'interagir avec les tableaux typés. La méthode load permet de charger des tableaux typés dans des vecteurs SIMD, la méthode store permet d'enregistrer des données SIMD dans des tableaux typés.

La méthode store() permet d'enregistrer toutes les voies du vecteurs, si on souhaite n'enregistrer qu'une, deux ou trois valeurs, on pourra respectivement utiliser les méthodes store1(), store2() ou store3().

Exemples

Dans les exemples suivants, on utilise un vecteur SIMD.Int32x4 qu'on enregistre dans un tableau typé Int32Array.

Enregistrer toutes les valeurs

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]

Enregistrer une valeur

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]

Enregistrer deux valeurs

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]

Enregistrer trois valeurs

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]

Spécifications

Compatibilité des navigateurs

Voir aussi

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