DataView.prototype.setBigUint64()

Baseline Widely available

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

DataView 인스턴스의 setBigUint64() 메서드는 BigInt를 받아 이 DataView의 지정된 바이트 오프셋의 8 바이트의 공간에 64비트 부호 없는 정수로 저장합니다. 정렬 제약 조건은 없으며, 범위 내의 모든 오프셋에서 멀티바이트 값을 저장할 수 있습니다.

시도해보기

구문

js
setBigUint64(byteOffset, value)
setBigUint64(byteOffset, value, littleEndian)

매개변수

byteOffset

데이터를 저장할 데이터 뷰의 시작점으로부터의 바이트 단위의 오프셋.

value

BigInt로 설정할 값. 어떻게 값이 바이트로 인코딩되는지는 값 인코딩 및 정규화를 보시기 바랍니다.

littleEndian Optional

리틀 엔디언 혹은 빅 엔디언 형식으로 데이터를 저장할지 여부를 나타냅니다. false 혹은 undefined이라면 빅 엔디언 값을 읽습니다.

반환 값

undefined.

예외

RangeError

뷰의 끝을 넘어서 저장하려고 하는 byteOffset이 설정되면 발생합니다.

예제

setBigUint64() 사용하기

js
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getBigUint64(1); // 768n

명세서

Specification
ECMAScript Language Specification
# sec-dataview.prototype.setbiguint64

브라우저 호환성

BCD tables only load in the browser

같이 보기