big-counter-x

big-counter-x

A big counter.

Version: 2.0.1
Author: Xotic750 [e-mail]
License: MIT
Copyright: Xotic750

• big-counter-x
  • module.exports ⏏
    • new module.exports()
    • ~get() ⇒ string
    • ~next() ⇒ Object
    • ~reset() ⇒ Object
    • ~toJSON() ⇒ string
    • ~toString() ⇒ string
    • ~valueOf() ⇒ string

module.exports ⏏

Kind: Exported class

new module.exports()

Incremental integer counter. Counts from 0 to very big intergers. Javascript´s number type allows you to count in integer steps from 0 to 9007199254740991. As of ES5, Strings can contain approximately 65000 characters and ES6 is supposed to handle the MAX_SAFE_INTEGER (though I don´t believe any environments supports this). This counter represents integer values as strings and can therefore count in integer steps from 0 to the maximum string length (that´s some 65000 digits). In the lower range, upto 9007199254740991, the strings can be converted to safe Javascript integers Number(value) or +value. This counter is great for any applications that need a really big count represented as a string, (an ID string).

Example

var BigCounter = require('big-counter-x');
var counter = new BigCounter();

counter.get(); // '0'
counter.next(); // counter object
counter.get(); // '1'

// Methods are chainable.
counter.next().next(); // counter object
counter.get(); // '3'

counter.reset(); // counter object
counter.get(); // '0'
counter.toString(); // '0'
counter.valueOf(); // '0'
counter.toJSON(); // '0'

// Values upto `9007199254740991` convert to numbers.
Number(counter); // 0
+counter; // 0

module.exports~get() ⇒ string

Gets the counter´s current value.

Kind: inner method of module.exports
Returns: string - A string representation of an integer.

module.exports~next() ⇒ Object

Increments the counter´s value by 1.

Kind: inner method of module.exports
Returns: Object - The counter object.

module.exports~reset() ⇒ Object

Resets the counter back to 0.

Kind: inner method of module.exports
Returns: Object - The counter object.

module.exports~toJSON() ⇒ string

Gets the counter´s current value.

Kind: inner method of module.exports
Returns: string - A string representation of an integer.

module.exports~toString() ⇒ string

Gets the counter´s current value.

Kind: inner method of module.exports
Returns: string - A string representation of an integer.

module.exports~valueOf() ⇒ string

Gets the counter´s current value.

Kind: inner method of module.exports
Returns: string - A string representation of an integer.