A Long class for representing a 64 bit two's-complement integer value derived from the Closure Library for stand-alone use and extended with unsigned support.

Background

As of ECMA-262 5th Edition, "all the positive and negative integers whose magnitude is no greater than 2⁵³ are representable in the Number type", which is "representing the doubleprecision 64-bit format IEEE 754 values as specified in the IEEE Standard for Binary Floating-Point Arithmetic". The maximum safe integer in JavaScript is 2⁵³-1.

Example: 2⁶⁴-1 is 18446744073709551615 but in JavaScript it evaluates to 18446744073709552000.

Furthermore, bitwise operators in JavaScript "deal only with integers in the range −2³¹ through 2³¹−1, inclusive, or in the range 0 through 2³²−1, inclusive. These operators accept any value of the Number type but first convert each such value to one of 2³² integer values."

In some use cases, however, it is required to be able to reliably work with and perform bitwise operations on the full 64 bits. This is where long.js comes into play.

Usage

The class is compatible with CommonJS and AMD loaders and is exposed globally as dcodeIO.Long if neither is available.

var Long = require("long");
 
var longVal = new Long(0xFFFFFFFF, 0x7FFFFFFF);
console.log(longVal.toString());
...

API

new Long(low, high=, unsigned=)

Constructs a 64 bit two's-complement integer, given its low and high 32 bit values as signed integers. See the from* functions below for more convenient ways of constructing Longs.

Long.MAX_UNSIGNED_VALUE

Maximum unsigned value.

Long.MAX_VALUE

Maximum signed value.

Long.MIN_VALUE

Minimum signed value.

Long.NEG_ONE

Signed negative one.

Long.ONE

Signed one.

Long.UONE

Unsigned one.

Long.UZERO

Unsigned zero.

Long.ZERO

Signed zero.

Long.fromBits(lowBits, highBits, unsigned=)

Returns a Long representing the 64 bit integer that comes by concatenating the given low and high bits. Each is assumed to use 32 bits.

Long.fromInt(value, unsigned=)

Returns a Long representing the given 32 bit integer value.

Long.fromNumber(value, unsigned=)

Returns a Long representing the given value, provided that it is a finite number. Otherwise, zero is returned.

Long.fromString(str, unsigned=, radix=)

Returns a Long representation of the given string, written using the specified radix.

Long.isLong(obj)

Tests if the specified object is a Long.

Long.fromValue(val)

Converts the specified value to a Long.

Long#high

The high 32 bits as a signed value.

Long#low

The low 32 bits as a signed value.

Long#unsigned

Whether unsigned or not.

Long#add(addend)

Returns the sum of this and the specified Long.

Long#and(other)

Returns the bitwise AND of this Long and the specified.

Long#compare/comp(other)

Compares this Long's value with the specified's.

Long#divide/div(divisor)

Returns this Long divided by the specified.

Long#equals/eq(other)

Tests if this Long's value equals the specified's.

Long#getHighBits()

Gets the high 32 bits as a signed integer.

Long#getHighBitsUnsigned()

Gets the high 32 bits as an unsigned integer.

Long#getLowBits()

Gets the low 32 bits as a signed integer.

Long#getLowBitsUnsigned()

Gets the low 32 bits as an unsigned integer.

Long#getNumBitsAbs()

Gets the number of bits needed to represent the absolute value of this Long.

Long#greaterThan/gt(other)

Tests if this Long's value is greater than the specified's.

Long#greaterThanOrEqual/gte(other)

Tests if this Long's value is greater than or equal the specified's.

Long#isEven()

Tests if this Long's value is even.

Long#isNegative()

Tests if this Long's value is negative.

Long#isOdd()

Tests if this Long's value is odd.

Long#isPositive()

Tests if this Long's value is positive.

Long#isZero()

Tests if this Long's value equals zero.

Long#lessThan/lt(other)

Tests if this Long's value is less than the specified's.

Long#lessThanOrEqual/lte(other)

Tests if this Long's value is less than or equal the specified's.

Long#modulo/mod(divisor)

Returns this Long modulo the specified.

Long#multiply/mul(multiplier)

Returns the product of this and the specified Long.

Long#negate/neg()

Negates this Long's value.

Long#not()

Returns the bitwise NOT of this Long.

Long#notEquals/neq(other)

Tests if this Long's value differs from the specified's.

Long#or(other)

Returns the bitwise OR of this Long and the specified.

Long#shiftLeft/shl(numBits)

Returns this Long with bits shifted to the left by the given amount.

Long#shiftRight/shr(numBits)

Returns this Long with bits arithmetically shifted to the right by the given amount.

Long#shiftRightUnsigned/shru(numBits)

Returns this Long with bits logically shifted to the right by the given amount.

Long#subtract/sub(subtrahend)

Returns the difference of this and the specified Long.

Long#toInt()

Converts the Long to a 32 bit integer, assuming it is a 32 bit integer.

Long#toNumber()

Converts the Long to a the nearest floating-point representation of this value (double, 53 bit mantissa).

Long#toSigned()

Converts this Long to signed.

Long#toString(radix=)

Converts the Long to a string written in the specified radix.

Long#toUnsigned()

Converts this Long to unsigned.

Long#xor(other)

Returns the bitwise XOR of this Long and the given one.

Downloads

• Distributions
• ZIP-Archive
• Tarball

License

Apache License, Version 2.0 - http://www.apache.org/licenses/LICENSE-2.0.html