[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/subarray [Back]  [Original]

TypedArray.prototype.subarray() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

TypedArray.prototype.subarray()

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La mthode subarray() permet de renvoyer un nouvel objet TypedArray bas sur le mme ArrayBuffer et dont les lments sont du mme type que l'objet TypedArray courant. Le paramtre dbut est considrer au sens large et le paramtre end est considrer au sens strict. TypedArray est l'un des types de tableaux typs.

Dans cet article

Exemple interactif

const uint8 = new Uint8Array([10, 20, 30, 40, 50]);

console.log(uint8.subarray(1, 3));
// Expected output: Uint8Array [20, 30]

console.log(uint8.subarray(1));
// Expected output: Uint8Array [20, 30, 40, 50]

Syntaxe

js
typedarray.subarray([dbut[,fin]])

Paramtres

dbutFacultatif

L'lment partir duquel commencer le nouveau tableau typ. Cet lment initial sera inclus dans le nouveau tableau (sens large). Si la valeur n'est pas dfinie, tout le tableau sera inclus dans la nouvelle vue.

finFacultatif

L'lment auquel finir le nouveau tableau typ. Cet lment ne fera pas partie du nouveau tableau (sens strict). Si ce paramtre n'est pas utilis, tous les lments contenus partir de dbut jusqu' la fin du tableau courant seront inclus dans la nouvelle vue.

Valeur de retour

Un nouvel objet TypedArray.

Description

L'intervalle dfini par dbut et fin est redimensionn si besoin pour tre un intervalle valide en regard du tableau courant. Si la longueur du nouveau tableau est ngative, elle est ramene zro. Si dbut ou fin a une valeur ngative, on prendra en compte la position partir de la fin du tableau et non partir du dbut de celui-ci.

On notera que cette mthode permet de crer un nouvelle vue sur le tampon (buffer) existant, tous les changements apports via le nouvel objet impacteront le tableau typ initial et vice versa.

Exemples

js
var buffer = new ArrayBuffer(8);
var uint8 = new Uint8Array(buffer);
uint8.set([1, 2, 3]);

console.log(uint8); // Uint8Array [ 1, 2, 3, 0, 0, 0, 0, 0 ]

var sub = uint8.subarray(0, 4);

console.log(sub); // Uint8Array [ 1, 2, 3, 0 ]

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-%typedarray%.prototype.subarray

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page