TypedArray.prototype.set()

Метод set() сохраняет значения в типизированном массиве, читая значения из предоставленного массива.

Синтаксис

typedarr.set(array [,offset])
typedarr.set(typedarray [,offset])

Параметры

array

Массив из которого копировать значения. Все значения из исходного массива копируются в текущий массив, за исключением случая, когда длина исходного массива плюс сдвиг превышают длину текущего массива, в таких ситуациях возникает исключение.

typedarray

Если исходный массив является типизированным массивом, то оба массива должны иметь одинаковый ArrayBuffer; браузер автоматически скопирует исходную размерность буфера в текущую размерность.

offset Необязательный

Сдвиг для текущего массива, с которого будет производиться запись исходного массива. Если значение опущено, то используется 0 (в таких ситуациях, исходный массив перезапишет значения в текущем массиве начиная с индекса 0).

Возвращаемое значение

undefined.

Исключения

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 ]

Спецификации

Совместимость с браузерами

Смотрите также

• JavaScript typed arrays
• TypedArray
• ArrayBuffer