BigInt.asIntN()

bits

반환된 BigInt에 사용할 수 있는 비트의 양입니다. 0에서 2⁵³ - 1 이하의 정수여야 합니다.

bigint

제공된 비트에 맞게 잘라낼 BigInt 값입니다.

부호 있는 정수인, bigint와 2^bits의 나머지 연산 값입니다.

RangeError

bits가 음수이거나 2⁵³ - 1 보다 크면 발생합니다.

BigInt.asIntN 메서드는 BigInt 값을 주어진 비트 수로 잘라내고 그 결과를 부호 있는 정수로 해석합니다. 예를 들어, BigInt.asIntN(3, 25n)의 경우 25n 값은 1n으로 잘립니다.

25n = 00011001 (이진수)
          ^=== 오직 남은 3개의 비트만 사용합니다
===>       001 (이진수) = 1n

남은 숫자의 첫 번째 비트가 1이라면, 결과는 음수입니다. 예를 들어 BigInt.asIntN(4, 25n)는 1001이 2의 보수 체계에서는 -7로 인코딩되기 때문에 -7n이 산출됩니다.

25n = 00011001 (이진수)
         ^==== 오직 남은 4개의 비트만 사용합니다
===>      1001 (이진수) = -7n

참고: BigInt 값은 언제나 이진수 2의 보수로 인코딩됩니다.

Number.prototype.toExponential()와 같은 유사한 언어 API와 달리 asIntN은 BigInt의 정적 속성이므로 항상 BigInt 값의 메서드가 아닌 BigInt.asIntN()으로 사용합니다. asIntN()을 "표준 라이브러리 함수"로 노출하면 asm.js와의 상호 운용을 할 수 있습니다.

64비트 연산 범위를 유지하는 데 BigInt.asIntN() 메서드가 유용할 수 있습니다.

const max = 2n ** (64n - 1n) - 1n;

BigInt.asIntN(64, max); // 9223372036854775807n

BigInt.asIntN(64, max + 1n); // -9223372036854775808n
// 2^63의 64번째 비트가 1이기 때문에 음수입니다.

• BigInt
• BigInt.asUintN()