TypedArray.prototype.copyWithin()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

TypedArray 인스턴스의 copyWithin() 메서드는 이 형식화 배열의 일부를 같은 형식화 배열의 다른 장소에 얕은 복사를 수행하며 배열의 길이를 수정하지 않고 해당 배열을 반환합니다. 이 메서드는 Array.prototype.copyWithin()와 같은 알고리즘을 가집니다.

시도해보기

구문

js
copyWithin(target, start)
copyWithin(target, start, end)

매개변수

target

시퀀스를 복사할 0 기반 인덱스로, 정수로 변환. 이는 start에 있는 요소가 복사될 위치에 해당하며, start과 end 사이의 모든 요소는 후속 인덱스에 복사됩니다.

start

요소 복사를 시작할 0 기반 인덱스로, 정수로 변환됩니다.

end Optional

요소 복사를 끝낼 0 기반 인덱스로, 정수로 변환됩니다. copyWithin()은 end를 포함하지 않고 end전 까지 복사합니다. copyWithin()는 여기까지 복사하지만 end를 포함하지는 않습니다.

반환 값

수정된 형식화 배열

설명

보다 자세한 설명은 Array.prototype.copyWithin()을 참고하시기 바랍니다. 이 메서드는 범용 메서드가 아니며 오직 형식화 배열 인스턴스에서만 호출할 수 있습니다.

예제

copyWithin() 사용하기

js
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);
uint8.set([1, 2, 3]);
console.log(uint8); // Uint8Array [ 1, 2, 3, 0, 0, 0, 0, 0 ]
uint8.copyWithin(3, 0, 3);
console.log(uint8); // Uint8Array [ 1, 2, 3, 1, 2, 3, 0, 0 ]

명세서

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.copywithin

브라우저 호환성

BCD tables only load in the browser

같이 보기