std_tools 0.1.4

Collection of general purpose tools for solving problems. Fundamentally extend the language without spoiling, so may be used solely or in conjunction with another module of such kind.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

let _ = require( 'wTools' );

//

// array[action]
var result = _.arrayAppend( [ 1, 2 ], [ 3, 4 ] );
console.log( 'Without ed' );
console.log( result );
// returns [ 1, 2, [ 3, 4 ] ] - dstArray

// array[action]ed
var result = _.arrayAppended( [ 1, 2 ], [ 3, 4 ] );
console.log( 'With ed' );
console.log( result );
// returns 2 - index

// array[action]
var result = _.arrayPrepend( [ 1, 2 ], [ 3, 4 ] );
console.log( 'Without ed' );
console.log( result );
// returns [ [ 3, 4 ], 1, 2 ] - dstArray

// array[action]ed
var result = _.arrayPrepended( [ 1, 2 ], [ 3, 4 ] );
console.log( 'With ed' );
console.log( result );
// returns 0 - index

//

// array[action][second]
var result = _.arrayRemoveElement( [ 1, 2, 2, 4, 2, 5 ], 2 );
console.log( 'Without [how many]' );
console.log( result );
// returns [ 1, 4, 5 ]

// array[action][second]Once
var result = _.arrayRemoveElementOnce( [ 1, 2, 2, 4, 2, 5 ], 2 );
console.log( 'With [Once]' );
console.log( result );
// returns [ 1, 2, 4, 2, 5 ]

// array[action][second]OnceStrictly
var result = _.arrayRemoveElementOnceStrictly( [ 1, 4, 2, 5 ], 2 );
console.log( 'With [OnceStrictly]' );
console.log( result );
// returns [ 1, 4, 5 ]

//

// array[action]Element
var result = _.arrayRemoveElement( [ 1, 2, 2, 4, 2, 5 ], [ 2, [ 4 ] ] );
console.log( 'second as element' );
console.log( result );
// returns [ 1, 2, 2, 4, 2, 5 ], routine treats element [ 2, [ 4 ] ] as scalar

// array[action]Array
var result = _.arrayRemoveArray( [ 1, 2, 2, 4, 2, 5 ], [ 2, [ 4 ] ] );
console.log( 'second as array' );
console.log( result );
// returns [ 1, 4, 5 ], routine treats inner array [ 4 ] as scalar

// array[action]Arrays
var result = _.arrayRemoveArrays( [ 1, 2, 2, 4, 2, 5 ], [ 2, [ 4 ] ] );
console.log( 'second as arrays' );
console.log( result );
// returns [ 1, 5 ]

// array[action]
var result = _.arrayFlatten( [ 1, 2, 2, 4, 2, 5 ], [ 2, [ 4 ] ] );
console.log( 'arrayFlatten' );
console.log( result );
// returns [ 1, 2, 2, 4, 2, 5, 2, 4 ]