TypedArray.prototype.set()

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

Синтаксис

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

Параметры

array
Массив, из которого необходимо скопировать значения. Все значения из исходного массива копируются в текущий массив, за исключением случая, когда длина исходного массива плюс сдвиг превышают длину текущего массива, в таких ситуациях возникает исключение.
typedarray
Если исходный массив является типизированным массивом, то оба массива могут ссылаться на один и тот же ArrayBuffer, т.е. быть разными представлениями (view) одного и того же 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 ]

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

Спецификация Статус Комментарий
Typed Array Specification Устаревшая Заменено в ECMAScript 6.
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'TypedArray.prototype.set' в этой спецификации.
Стандарт Изначальное определение.
ECMAScript (ECMA-262)
Определение 'TypedArray.prototype.set' в этой спецификации.
Живой стандарт  

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

BCD tables only load in the browser

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