array-step

0.0.2 • Public • Published

array-step

Build Status Dependency Status devDependency Status

Step through an array, or an array of arrays.

examples

Works basically like Array.prototype.shift when it is used on an array of non-array objects.

var step = require('array-step')
var arr = [ 0, 1, 2, 3, 4]
 
step(arr) //returns 0,         arr = [ 1, 2, 3, 4 ]
step(arr) //returns 1,         arr = [ 2, 3, 4 ]
step(arr) //returns 2,         arr = [ 3, 4 ]
step(arr) //returns 3,         arr = [ 4 ]
step(arr) //returns 4,         arr = []
step(arr) //returns undefined, arr = []

This becomes much more useful when it is used with an array of arrays.

var step = require('array-step')
var arr = [
    [0, 2, 4, 5],
    [1, 3]
]
 
step(arr) //returns 0,         arr = [ [1, 3], [2, 4, 5] ]
step(arr) //returns 1,         arr = [ [2, 4, 5], [3] ]
step(arr) //returns 2,         arr = [ [3], [4, 5] ]
step(arr) //returns 3,         arr = [ [4, 5] ]
step(arr) //returns 4,         arr = [ [5] ]
step(arr) //returns 5,         arr = []
step(arr) //returns undefined, arr = []

api

var step = require('array-step')

step(arr)

  • Takes an array of arrays, or an array.
  • Returns the element that was removed.
  • Mutates the array that was passed in.

install

Install with npm:

npm install array-step

License

VOL

Package Sidebar

Install

npm i array-step

Weekly Downloads

1

Version

0.0.2

License

VOL

Last publish

Collaborators

  • artskydj