DataView.prototype.getBigInt64()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2021년 9월.
DataView 인스턴스의 getBigInt64() 메서드는 이 DataView의 지정된 바이트 오프셋에서
8바이트를 읽고 이를 부호있는 64비트 정수로 해석합니다. 정렬 제약 조건은 없으며, 범위 내의 모든 오프셋에서 멀티바이트 값을 가져올 수 있습니다.
시도해 보기
// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);
// Highest possible BigInt value that fits in a signed 64-bit integer
const max = 2n ** (64n - 1n) - 1n;
const view = new DataView(buffer);
view.setBigInt64(1, max);
console.log(view.getBigInt64(1));
// Expected output: 9223372036854775807n
구문
js
getBigInt64(byteOffset)
getBigInt64(byteOffset, littleEndian)
매개변수
byteOffset-
데이터를 읽을 데이터 뷰의 시작점으로부터의 오프셋(바이트).
littleEndianOptional-
리틀 엔디언 혹은 빅 엔디언 형식으로 저장할지 여부를 나타냅니다.
false혹은undefined이라면 빅 엔디안 값을 읽습니다.
반환 값
-263 이상 263-1 이하의 BigInt
예외
RangeError-
byteOffset이 이 뷰의 끝을 넘어 읽을 수 있는 값이 설정될 경우 발생합니다.
예제
getBigInt64() 사용하기
js
const { buffer } = new Uint8Array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
const dataview = new DataView(buffer);
console.log(dataview.getBigInt64(1)); // 72623859790382856n
명세서
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-dataview.prototype.getbigint64 |
브라우저 호환성
Loading…