Class BigInt
TopLevel
Class BigInt
Object
BigInt
A BigInt object is a wrapper for a primitive bigint value. bigint values can be numbers too large to be stored as number values.

A bigint literal in code is an integer number with an appended n.

Example:

 var hugeNumber = 1245678901234567890n;
 var hugeNumberObject = BigInt( hugeNumber );
 
API Versioned:
From version 22.7.
Constructor Summary
BigInt()
Constructs a BigInt with value 0.
BigInt(value : BigInt)
Constructs a new BigInt using the specified BigInt.
BigInt(value : String)
Constructs a BigInt using the specified value.
Method Summary
static asIntN(bits : Number, value : BigInt) : BigInt
Clamps the given BigInt value to a signed integer with a given precision.
static asUintN(bits : Number, value : BigInt) : BigInt
Clamps the given BigInt value to an unsigned integer with a given precision.
toLocaleString() : String
Converts this BigInt to a String using local number formatting conventions.
toString() : String
A String representation of this BigInt.
toString(radix : Number) : String
Converts the BigInt into a string using the specified radix (base).
Constructor Detail
BigInt
public BigInt()
Constructs a BigInt with value 0.

BigInt
public BigInt(value : BigInt)
Constructs a new BigInt using the specified BigInt.
Parameters:
value - the BigInt to use.

BigInt
public BigInt(value : String)
Constructs a BigInt using the specified value.

Beside decimal numbers also binary, octal and hexadecimal numbers are supported:

 var decimal = BigInt( "12" );
 var binary  = BigInt( "0b1100" );
 var octal   = BigInt( "0o14" );
 var hex     = BigInt( "0xC" );
 
Parameters:
value - the value to use when creating the BigInt.

Method Detail
asIntN
static asIntN(bits : Number, value : BigInt) : BigInt
Clamps the given BigInt value to a signed integer with a given precision.
Parameters:
bits - Number of bits required for resulting integer.
value - The value to be clamped to the given number of bits.
Returns:
The value modulo 2bits, as a signed integer.

asUintN
static asUintN(bits : Number, value : BigInt) : BigInt
Clamps the given BigInt value to an unsigned integer with a given precision.
Parameters:
bits - Number of bits required for resulting integer.
value - The value to be clamped to the given number of bits.
Returns:
The value modulo 2bits, as an unsigned integer.

toLocaleString
toLocaleString() : String
Converts this BigInt to a String using local number formatting conventions.
The current implementation actually only returns the same as toString().
Returns:
a String using local number formatting conventions.

toString
toString() : String
A String representation of this BigInt.
Returns:
a String representation of this BigInt.

toString
toString(radix : Number) : String
Converts the BigInt into a string using the specified radix (base).
Parameters:
radix - the radix to use.
Returns:
a String representation of this BigInt.