Pkg
Stats

npm package discovery and stats viewer.

Discover Tips

General search
[free text search, go nuts!]
Package details
pkg:[package-name]
User packages
@[username]

Sponsor

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Twitter
@PkgStats
GitHub
pkgstats
Twitter
@ryanhefner
GitHub
ryanhefner
Site
ryanhefner.com

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

Framework
react / react-dom
Server
next / express / next-routes
Data Store
redux / react-redux / next-redux-wrapper / redux-thunk / redux-logger
Caching
lru-cache
CSS / Styling
next-page-transitions / styled-components
Typeface
@ibm/plex
Avatars
gravatar
Data Viz
chart.js / react-sparklines
Date formatting
dayjs
Infinite scrolling
react-scroll-trigger
Markdown rendering
react-markdown
Repository url parsing
hosted-git-info
User data
npm-user
Compiling
babel-plugin-module-resolver / babel-plugin-styled-components
Types
prop-types
Odds & Ends
es6-promise / isomorphic-fetch

© 2024 – Pkg Stats / Ryan Hefner

long-mutable

v3.2.7

Published

2 years ago

A Long class for representing a 64-bit two's-complement integer value.

Downloads

11

0High
0Medium
0Low

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 253 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 253-1.

Example: 264-1 is 18446744073709551615 but in JavaScript it evaluates to 18446744073709552000.

Furthermore, bitwise operators in JavaScript "deal only with integers in the range −231 through 231−1, inclusive, or in the range 0 through 232−1, inclusive. These operators accept any value of the Number type but first convert each such value to one of 232 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.

| Parameter | Type | Description |-----------------|-----------------|--------------- | low | number | The low (signed) 32 bits of the long | high | number | The high (signed) 32 bits of the long | unsigned | boolean | Whether unsigned or not, defaults to false for signed

Long.MAX_UNSIGNED_VALUE

Maximum unsigned value.

| | | |-----------------|-----------------| | @type | !Long |

Long.MAX_VALUE

Maximum signed value.

| | | |-----------------|-----------------| | @type | !Long |

Long.MIN_VALUE

Minimum signed value.

| | | |-----------------|-----------------| | @type | !Long |

Long.NEG_ONE

Signed negative one.

| | | |-----------------|-----------------| | @type | !Long |

Long.ONE

Signed one.

| | | |-----------------|-----------------| | @type | !Long |

Long.UONE

Unsigned one.

| | | |-----------------|-----------------| | @type | !Long |

Long.UZERO

Unsigned zero.

| | | |-----------------|-----------------| | @type | !Long |

Long.ZERO

Signed zero.

| | | |-----------------|-----------------| | @type | !Long |

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.

| Parameter | Type | Description |-----------------|-----------------|--------------- | lowBits | number | The low 32 bits | highBits | number | The high 32 bits | unsigned | boolean | Whether unsigned or not, defaults to false for signed | @returns | !Long | The corresponding Long value

Long.fromInt(value, unsigned=)

Returns a Long representing the given 32 bit integer value.

| Parameter | Type | Description |-----------------|-----------------|--------------- | value | number | The 32 bit integer in question | unsigned | boolean | Whether unsigned or not, defaults to false for signed | @returns | !Long | The corresponding Long value

Long.fromNumber(value, unsigned=)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | value | number | The number in question | unsigned | boolean | Whether unsigned or not, defaults to false for signed | @returns | !Long | The corresponding Long value

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

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | str | string | The textual representation of the Long | unsigned | boolean | number | Whether unsigned or not, defaults to false for signed | radix | number | The radix in which the text is written (2-36), defaults to 10 | @returns | !Long | The corresponding Long value

Long.isLong(obj)

Tests if the specified object is a Long.

| Parameter | Type | Description |-----------------|-----------------|--------------- | obj | *** | Object | @returns | boolean |

Long.fromValue(val)

Converts the specified value to a Long.

| Parameter | Type | Description |-----------------|-----------------|--------------- | val | !Long | number | string | !{low: number, high: number, unsigned: boolean} | Value | @returns | !Long |

Long#high

The high 32 bits as a signed value.

| | | |-----------------|-----------------| | @type | number |

Long#low

The low 32 bits as a signed value.

| | | |-----------------|-----------------| | @type | number |

Long#unsigned

Whether unsigned or not.

| | | |-----------------|-----------------| | @type | boolean |

Long#add(addend)

Returns the sum of this and the specified Long.

| Parameter | Type | Description |-----------------|-----------------|--------------- | addend | !Long | number | string | Addend | @returns | !Long | Sum

Long#and(other)

Returns the bitwise AND of this Long and the specified.

| Parameter | Type | Description |-----------------|-----------------|--------------- | other | !Long | number | string | Other Long | @returns | !Long |

Long#compare/comp(other)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | other | !Long | number | string | Other value | @returns | number | 0 if they are the same, 1 if the this is greater and -1 if the given one is greater

Long#divide/div(divisor)

Returns this Long divided by the specified.

| Parameter | Type | Description |-----------------|-----------------|--------------- | divisor | !Long | number | string | Divisor | @returns | !Long | Quotient

Long#equals/eq(other)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | other | !Long | number | string | Other value | @returns | boolean |

Long#getHighBits()

Gets the high 32 bits as a signed integer.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | number | Signed high bits

Long#getHighBitsUnsigned()

Gets the high 32 bits as an unsigned integer.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | number | Unsigned high bits

Long#getLowBits()

Gets the low 32 bits as a signed integer.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | number | Signed low bits

Long#getLowBitsUnsigned()

Gets the low 32 bits as an unsigned integer.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | number | Unsigned low bits

Long#getNumBitsAbs()

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | number |

Long#greaterThan/gt(other)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | other | !Long | number | string | Other value | @returns | boolean |

Long#greaterThanOrEqual/gte(other)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | other | !Long | number | string | Other value | @returns | boolean |

Long#isEven()

Tests if this Long's value is even.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | boolean |

Long#isNegative()

Tests if this Long's value is negative.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | boolean |

Long#isOdd()

Tests if this Long's value is odd.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | boolean |

Long#isPositive()

Tests if this Long's value is positive.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | boolean |

Long#isZero()

Tests if this Long's value equals zero.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | boolean |

Long#lessThan/lt(other)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | other | !Long | number | string | Other value | @returns | boolean |

Long#lessThanOrEqual/lte(other)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | other | !Long | number | string | Other value | @returns | boolean |

Long#modulo/mod(divisor)

Returns this Long modulo the specified.

| Parameter | Type | Description |-----------------|-----------------|--------------- | divisor | !Long | number | string | Divisor | @returns | !Long | Remainder

Long#multiply/mul(multiplier)

Returns the product of this and the specified Long.

| Parameter | Type | Description |-----------------|-----------------|--------------- | multiplier | !Long | number | string | Multiplier | @returns | !Long | Product

Long#negate/neg()

Negates this Long's value.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | !Long | Negated Long

Long#not()

Returns the bitwise NOT of this Long.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | !Long |

Long#notEquals/neq(other)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | other | !Long | number | string | Other value | @returns | boolean |

Long#or(other)

Returns the bitwise OR of this Long and the specified.

| Parameter | Type | Description |-----------------|-----------------|--------------- | other | !Long | number | string | Other Long | @returns | !Long |

Long#shiftLeft/shl(numBits)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | numBits | number | !Long | Number of bits | @returns | !Long | Shifted Long

Long#shiftRight/shr(numBits)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | numBits | number | !Long | Number of bits | @returns | !Long | Shifted Long

Long#shiftRightUnsigned/shru(numBits)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | numBits | number | !Long | Number of bits | @returns | !Long | Shifted Long

Long#subtract/sub(subtrahend)

Returns the difference of this and the specified Long.

| Parameter | Type | Description |-----------------|-----------------|--------------- | subtrahend | !Long | number | string | Subtrahend | @returns | !Long | Difference

Long#toInt()

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | number |

Long#toNumber()

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | number |

Long#toSigned()

Converts this Long to signed.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | !Long | Signed long

Long#toString(radix=)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | radix | number | Radix (2-36), defaults to 10 | @returns | string | | @throws | RangeError | If radix is out of range

Long#toUnsigned()

Converts this Long to unsigned.

| Parameter | Type | Description |-----------------|-----------------|--------------- | @returns | !Long | Unsigned long

Long#xor(other)

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

| Parameter | Type | Description |-----------------|-----------------|--------------- | other | !Long | number | string | Other Long | @returns | !Long |

Downloads

License

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