Class BigIntCombinatorInternal

constructor

• new BigIntCombinator(): BigIntCombinator

  Returns BigIntCombinator

Readonlyzero

and

• and(a: bigint, b: bigint): bigint

  Returns the bitwise AND of a and b.

  Parameters

  • a: bigint

    First operand.

  • b: bigint

    Second operand.

  Returns bigint

  a & b as a bigint.

andNot

• andNot(a: bigint, b: bigint): bigint

  Returns the bitwise AND of a and ~b. Same as combinator.and(a, combinator.not(b))

  Parameters

  • a: bigint

    First operand.

  • b: bigint

    Second operand.

  Returns bigint

  a & ~b as a bigint.

not

• not(a: bigint): bigint

  Returns the bitwise NOT of a (one's complement inversion).

  Parameters

  • a: bigint

    Value to invert.

  Returns bigint

  ~a as a bigint.

or

• or(a: bigint, b: bigint): bigint

  Returns the bitwise OR of a and b.

  Parameters

  • a: bigint

    First operand.

  • b: bigint

    Second operand.

  Returns bigint

  a | b as a bigint.

popcount

• popcount(a: bigint): number

  Counts the number of set bits (population count) in a.

  Unlike the number variant, negative bigint values cannot be reinterpreted as unsigned because bigint has no fixed width and a negative value conceptually has infinitely many set bits. Passing a negative value throws a RangeError with the offending value included in the message.

  Parameters

  • a: bigint

    Non-negative value whose set bits are counted.

  Returns number

  The count of bits set to 1 in a.

  Throws

  If a is negative.

  Example

  c.popcount(0n)                // → 0
  c.popcount(0b0111n)           // → 3
  c.popcount((1n << 128n) - 1n) // → 128
  c.popcount(-1n)               // throws RangeError
  Copy

shiftL

• shiftL(value: bigint, shift: number): bigint

  Shifts value left by shift bit positions.

  The shift argument is a plain number and is converted to BigInt(shift) internally. Unlike the number variant, there is no 31-bit cap — values shifted beyond bit 31 or bit 63 remain exact and positive.

  Parameters

  • value: bigint

    Value to shift.

  • shift: number

    Number of positions to shift left (no upper bound enforced).

  Returns bigint

  value << BigInt(shift) as a bigint.

  Example

  c.shiftL(1n, 31)  // → 2147483648n  (not −2147483648 like number)
  c.shiftL(1n, 100) // → 2n ** 100n
  Copy

xor

• xor(a: bigint, b: bigint): bigint

  Returns the bitwise XOR of a and b.

  Parameters

  • a: bigint

    First operand.

  • b: bigint

    Second operand.

  Returns bigint

  a ^ b as a bigint.