nv-array-split

nv-array-split
============
- nv-array-split

install
=======
- npm install nv-array-split

usage
=====

const {
all,
cond,
rng,
slc,
join,
gen,
} = require("nv-array-split")

example
-------

var arr = Array.from("example")

var sps = [/[aieou]/,"m",(r,i)=>r==='p'||r==='l']

> slc(arr,sps)
[ [ 'e' ], [ 'x' ], [ 'a' ], [ 'm' ], [ 'p', 'l' ], [ 'e' ] ]
>
> rng(arr,sps)
[ [ 0, 1 ], [ 1, 2 ], [ 2, 3 ], [ 3, 4 ], [ 4, 6 ], [ 6, 7 ] ]
>

> join(arr,sps,'-')
[ 'e', 'x', 'a', 'm', 'p-l', 'e' ]
>

> cond(arr,sps)
[
/[aieou]/,
undefined,
/[aieou]/,
'm',
[Function (anonymous)],
/[aieou]/
]
>
> cond(arr,sps)[4].toString()
"(r,i)=>r==='p'||r==='l'"
>

> all(arr,sps)
[
[ 0, 1, 0 ],
[ 1, 2, 3 ],
[ 2, 3, 0 ],
[ 3, 4, 1 ],
[ 4, 6, 2 ],
[ 6, 7, 0 ]
]
>

###

var is_sp = (v)=>v === null || v === true || v === false

var arr = [null,100,200,300,true,'A',false,'B','C']
var g = gen(arr,is_sp)

> Array.from(g)
[ [ 100, 200, 300 ], [ 'A' ], [ 'B', 'C' ] ]
>

var arr = [null,100,200,300,true,'A',false,'B','C']
var g = gen(arr,is_sp,true)
Array.from(g)
> [ [ null, 100, 200, 300 ], [ true, 'A' ], [ false, 'B', 'C' ] ]

var arr = [null,100,200,300,true,'A',false]
var g = gen(arr,is_sp)

> Array.from(g)
[ [ 100, 200, 300 ], [ 'A' ], [] ]
>

var arr = [100,200,300,true,'A',false]
var g = gen(arr,is_sp)
> Array.from(g)
[ [ 100, 200, 300 ], [ 'A' ], [] ]
>

var arr = [100,200,300,true,'A',false]
var g = gen(arr,is_sp,true)
> var rslts = Array.from(g)
> rslts
[ [ Symbol(), 100, 200, 300 ], [ true, 'A' ], [ false ] ]
>
> gen.is_dummy_sp(rslts[0][0])
true
>

var arr = [null,100,200,300,true,'A',false,'B','C']
var g = gen(arr,is_sp,true,(r)=>({head:r[0],body:r.slice(1)}))

> Array.from(g)
[
{ head: null, body: [ 100, 200, 300 ] },
{ head: true, body: [ 'A' ] },
{ head: false, body: [ 'B', 'C' ] }
]
>

SPS
====
type F = (r:any,i:number)=>boolean
type SP = string | RegExp | Set | Array | F
type SPS = Array

API
====

- ary\_sp.all(arr,sps)
- ary\_sp.cond(arr,sps)
- ary\_sp.slc(arr,sps)
- ary\_sp.rng(arr,sps)
- ary\_sp.join(arr,sps,delimeter='')
- ary\_sp.gen(arr,is\_sp,with\_sp=false,aggf=(r)=\>r)

LICENSE
=======
- ISC