TypedArray.prototype.set()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Метод set() сохраняет значения в типизированном массиве, читая значения из предоставленного массива.
Синтаксис
typedarr.set(array [,offset]) typedarr.set(typedarray [,offset])
Параметры
- array
-
Массив, из которого необходимо скопировать значения. Все значения из исходного массива копируются в текущий массив, за исключением случая, когда длина исходного массива плюс сдвиг превышают длину текущего массива, в таких ситуациях возникает исключение.
- typedarray
-
Если исходный массив является типизированным массивом, то оба массива могут ссылаться на один и тот же
ArrayBuffer, т.е. быть разными представлениями (view) одного и того же ArrayBuffer; браузер скопирует исходный диапазон буфера в диапазон назначения даже в случае перекрытия диапазонов. - offset Необязательный
-
Сдвиг для текущего массива, с которого будет производиться запись исходного массива. Если значение опущено, то используется 0 (в таких ситуациях, исходный массив перезапишет значения в текущем массиве начиная с индекса 0).
Возвращаемое значение
Исключения
RangeError-
Возникает, в случае, когда с текущим сдвигом элементы будут сохраняться за пределы типизированного массива.
Примеры
Использование метода set
var buffer = new ArrayBuffer(8);
var uint8 = new Uint8Array(buffer);
uint8.set([1, 2, 3], 3);
console.log(uint8); // Uint8Array [ 0, 0, 0, 1, 2, 3, 0, 0 ]
Спецификации
| Specification |
|---|
| ECMAScript Language Specification # sec-%typedarray%.prototype.set |
Совместимость с браузерами
BCD tables only load in the browser