Newton's Programmatic Measurements

    array.prototype.overflow

    1.0.3 • Public • Published

    Array.prototype.overflow

    Adds a function called overflow to Array and all built-in numeric arrays as well.

    That means if you import it and hook-it to Array, then you can get the last element of an array with -1, just like in Python.

    let last_element = ["first", "last"].overflow(-1);
    // last_element = "last"
    
    ...

    But unlike python you can overflow the boundaries more than once.

    let last_element = ["first", "last"].overflow(-3);
    // last_element = "last"
    
    ...

    Overflow literally ties both ends of the array together and makes it a circular buffer.

    import { hook } from 'array.prototype.overflow'
    hook()
    
    let array = ['first', 'last']
    let string = ''
    for (let i = 0; i < 10; i++) {
        string += array.overflow(i) + ', '
    }
    console.log(string.slice(0, -2))
    //    first, last, first, last, first, last, first, last, first, last
    Note
    When testing the code I ran into problems with indexes above 9.000.000.000.000.000

    Install

    It's easy.

    npm install --save array.prototype.overflow
    

    Use

    Import and hook it ...

    import { hook } from 'array.prototype.overflow';
    hook();
    
    ...

    Or require it, the old fashion way ...

    var overflow = require('array.prototype.overflow');
    overflow.hook();
    
    ...

    The Array.prototype.of() shorthand

    There is a shorthand function called .of() that you can use instead of .overflow(), but you will have to import of instead of hook, like this:

    import { of } from 'array.prototype.overflow';
    of();
    
    let last_element = ["first", "last"].of(-1);
    // last_element = "last"
    
    ...

    Or the old fashion way ...

    var overflow = require('array.prototype.overflow');
    overflow.of();
    
    let last_element = ["first", "last"].of(-1);
    // last_element = "last"
    
    ...
    Note
    JavaScript's Array already has a function called .of(), but it's not a part of the prototype, so it's safe to use. If however you decide to use it, know that people could get confused as the functions are not related in any way. More on Array.of here

    Documentation

    Documentation

    License

    MIT

    Install

    npm i array.prototype.overflow

    DownloadsWeekly Downloads

    7

    Version

    1.0.3

    License

    MIT

    Unpacked Size

    19.9 kB

    Total Files

    7

    Last publish

    Collaborators

    • throstur