Class BigInt

TopLevel

Class BigInt

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.

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.

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).

Methods inherited from class Object

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

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.

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 2^bits, 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 2^bits, 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.