array-move-slice
Move a slice of an array to a different position in the array
Very similar to array-move but with this package you can move single element or a slice of elements (only continuous slices though). If you need to move multiple items that are not in sequence try using array-move-multiple
Install
$ npm install array-move-slice
Usage
const input = 'a' 'b' 'c' 'd' 'e'; // moving single itemconst array1 = ;console;// ["a", "c", "b", "d", "e"] // moving a slice of itemsconst array2 = ;console;// ["a", "c", "d", "b", "e"] // using -ve value to move a slice to end of the arrayconst array3 = ;console;// ["d", "e", "a", "b", "c"] // using -ve value for fromIndex to move a slice from the end of the arrayconst array4 = ;console// ["e", "a", "b", "c", "d"]
API Reference
arrayMoveSlice(array, to, from, count)
Clones the given array
, moves the item / slice of items (if a non-zero count
parameter value is passed) to a new position in the new array. The given array
is not mutated.
arrayMoveSliceMutate(array, to, from, count)
Same as arrayMoveSlice
but it mutates the array
passed to it. Useful for operating on huge arrays where performance can become a factor.
Params
array - Type Array<any>
- the array to be operated on
to - Type number
- the index of where the item / slice of items need to be moved to. If negative, it will be used as an offset from the end (like the native Array.prototype.slice
method).
from - Type number
- the index of the item / start of the slice of items that need to be moved. If negative, it will be used as an offset from the end (like the native Array.prototype.slice
method).
count - Type number
or undefined
- the number of elements to be moved in the slice. It is optional and defaults to 1
. If a value is passed, it must be more than one.