TypedArray.prototype.set()

Метод set() экземпляров TypedArray сохраняет несколько значений в типизированном массиве, считывая входные значения из указанного массива.

Попробуйте

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);

// Copy the values into the array starting at index 3
uint8.set([1, 2, 3], 3);

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

Синтаксис

set(array)
set(array, targetOffset)

set(typedarray)
set(typedarray, targetOffset)

Параметры

array

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

typedarray

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

targetOffset Необязательно

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

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

Нет (undefined).

Исключения

RangeError

Выбрасывается в одном из следующих случаев:

• Элемент будет сохранен за пределами типизированного массива, либо потому, что targetOffset слишком велик, либо потому, что array или typedarray слишком велики.
• targetOffset отрицателен.

Примеры

Использование set()

const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);

uint8.set([1, 2, 3], 3);

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

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

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

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

• Полифил TypedArray.prototype.set в core-js
• Руководство по типизированным массивам JavaScript
• TypedArray
• ArrayBuffer