64비트 부호 없는 정수 처리: BigUint64Array의 용도와 대체 코드 샘플

2025-11-17

친절하고 이해하기 쉽게 한국어로 설명해 드릴게요!

BigUint64Array는 타입 배열(Typed Array)의 한 종류입니다.

용도 각각 64비트(8바이트)로 표현되는 부호 없는 정수(0 또는 양수)들을 메모리상에 연속적으로 저장하는 데 사용됩니다.

특징
일반적인 JavaScript의 Number 타입(최대 253−1까지의 정수만 안전하게 표현 가능)으로는 다룰 수 없는 매우 큰 정수를 다룰 수 있게 해줍니다.

값 표현
배열의 각 요소는 BigInt 타입으로 저장됩니다.

BigUint64Array는 반드시 BigInt 타입의 값만 요소로 받아들입니다. 일반 Number를 할당하려고 하면 에러가 발생합니다.

일반 숫자 123을 할당하려고 할 때

const bigArr = new BigUint64Array(2);
// 에러 발생! BigInt가 아닌 Number 타입입니다.
// Cannot convert 123 to a BigInt
// bigArr[0] = 123;

숫자 뒤에 n 접미사를 붙여서 명시적으로 BigInt 리터럴로 만들어주어야 합니다.

// 1. 초기화 시:
const bigArr1 = new BigUint64Array([1n, 2n, 3n]);
console.log(bigArr1); // BigUint64Array [1n, 2n, 3n]

// 2. 값 할당 시:
const bigArr2 = new BigUint64Array(2);
bigArr2[0] = 123n; // 'n'을 붙여 BigInt로 변환
bigArr2[1] = 9007199254740991n + 1n; // 매우 큰 숫자도 처리 가능
console.log(bigArr2[0]); // 123n
console.log(bigArr2[1]); // 9007199254740992n

BigUint64Array는 64비트 부호 없는 정수만을 저장하므로, 음수나 264−1보다 큰 양수를 저장하려고 하면 값이 잘리거나 에러가 발생할 수 있습니다.

음수를 할당하려고 할 때

const bigArr = new BigUint64Array(1);
// 에러 발생! 음수는 Unsigned Integer 타입에 들어갈 수 없습니다.
// BigInt must not be negative
// bigArr[0] = -1n;

부호 있는 정수가 필요할 경우
BigInt64Array를 사용합니다.

64비트를 초과하는 큰 양수가 필요할 경우
JavaScript의 일반 배열(Array)에 BigInt를 담아 사용하거나, 여러 요소를 조합하는 복잡한 로직을 고려해야 합니다.

// 부호 있는 64비트 정수를 위한 대체 (Signed 64-bit)
const signedBigArr = new BigInt64Array(1);
signedBigArr[0] = -1n; // BigInt64Array에는 음수 할당 가능
console.log("Signed Array:", signedBigArr[0]); // -1n

// BigUint64Array는 0n으로 변환됩니다 (값의 잘림/Overflow 처리 방식에 따라 다름)
// let overflow = (2n ** 64n);
// let bigArrOverflow = new BigUint64Array([overflow]); // 값 잘림 (Modulo $2^{64}$)
// console.log("Overflow:", bigArrOverflow[0]); // 0n

BigUint64Array와 BigInt는 비교적 최신 JavaScript 기능입니다. 구형 브라우저나 Node.js 환경에서는 지원하지 않을 수 있습니다.

지원하지 않는 구형 환경에서 코드를 실행할 때

// ReferenceError: BigUint64Array is not defined
// TypeError: BigInt is not a constructor

폴리필(Polyfill) 또는 트랜스파일러(Transpiler) 사용
Babel과 같은 도구를 사용하여 코드를 구형 JavaScript로 변환합니다. 하지만 BigInt의 완전한 폴리필은 어렵기 때문에, 대상 환경의 지원 여부를 확인하는 것이 중요합니다.

지원 여부 확인 로직
코드를 실행하기 전에 해당 기능의 지원 여부를 확인하여, 지원하지 않을 경우 대체 로직을 실행하도록 합니다.

// 호환성 확인
if (typeof BigUint64Array === 'undefined') {
    // BigUint64Array가 지원되지 않을 경우의 대체 로직
    console.warn("현재 환경은 BigUint64Array를 지원하지 않습니다. Number 배열로 대체합니다.");
    
    // 이 경우, 매우 큰 숫자는 안전하게 처리되지 못할 수 있습니다.
    const fallbackArray = [123, 456]; 
    console.log(fallbackArray);
} else {
    // BigUint64Array를 사용할 수 있는 경우
    const bigArr = new BigUint64Array([123n, 456n]);
    console.log(bigArr);
}