long

What is long?

The 'long' npm package provides a comprehensive library for representing, converting, and performing arithmetic operations on 64-bit integers. This is particularly useful in environments like JavaScript, where the standard Number type can only safely represent integers up to 53 bits.

What are long's main functionalities?

Creation of Long integers

This feature allows the creation of 64-bit integers. The constructor takes two arguments representing the low and high 32 bits of the integer, respectively.

const Long = require('long');
let longVal = new Long(0xFFFFFFFF, 0x7FFFFFFF);

Arithmetic operations

This feature supports basic arithmetic operations such as addition, subtraction, multiplication, and division on 64-bit integers.

const Long = require('long');
let long1 = new Long(1, 0);
let long2 = new Long(1, 0);
let sum = long1.add(long2);

Comparison operations

This feature enables comparison operations like less than, greater than, equals, etc., between two Long instances.

const Long = require('long');
let long1 = new Long(1, 0);
let long2 = new Long(2, 0);
let isLessThan = long1.lessThan(long2);

Other packages similar to long

bignum

The 'bignum' package also provides arbitrary precision arithmetic operations. Unlike 'long', which is limited to 64-bit, 'bignum' can handle much larger numbers, making it suitable for applications requiring high precision.

bigint

Similar to 'long', 'bigint' supports large integer operations. However, 'bigint' is built into modern JavaScript environments as a native type, offering better performance and integration with the language compared to 'long', which is a library.

README

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.

Why?

As of the ECMAScript specification, number types have a maximum value of 2^53. Beyond that, behaviour might be unexpected. Furthermore, bitwise operations can only be performed on 32bit numbers. However, in some use cases it is required to be able to perform reliable mathematical and/or bitwise operations on the full 64bits. This is where Long.js comes into play.

Features

• CommonJS compatible
• RequireJS/AMD compatible
• Shim compatible (include the script, then use var Long = dcodeIO.Long;)
• node.js compatible, also available via npm
• Fully documented using jsdoc3
• API-compatible to the Closure Library implementation
• Zero production dependencies
• Small footprint

Usage

node.js / CommonJS

Install: npm install long

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

RequireJS / AMD

require.config({
    "paths": {
        "Math/Long": "/path/to/Long.js"
    }
});
require(["Math/Long"], function(Long) {
    var longVal = new Long(0xFFFFFFFF, 0x7FFFFFFF);
    console.log(longVal.toString());
});

Browser / shim

<script src="Long.min.js"></script>

var Long = dcodeIO.Long;
var longVal = new Long(0xFFFFFFFF, 0x7FFFFFFF);
alert(longVal.toString());

Documentation

• View the API documentation

Downloads

• Distributions
• ZIP-Archive
• Tarball

License

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