arrayext.js v1.0.6

arrayExt.js

A lightwieght Javascript Library that extends Javascript's array functionalities.

Using arrayExt.js

Just import arrayExt.js file from the package folder into your project and arrays will automatically have new functions.

• index
• same
• hasList
• copy
• sublist
• shove
• insert
• remove
• clean
• intersection
• deduct
• merge
• isArray

Usage:

var foo1 = [{a: 1, b: 2}, {a: 3, b: 4}];
var foo2 = [1,2,3,4];

var check = function(elem, value) {     /* elem is the array element and value the value we send */
  return elem.a === value;
};

foo1.index(3, check);       /* Returns 1 */
foo1.index(8, check);       /* Returns -1 */

foo2.index(3);              /* Returns 2 */

Usage:

var foo1 = [1,3,5,7,9];
var foo2 = [1,3,5,7,9];

var check = function(elem1, elem2){      /* elem1 is the array element and elem2 the element of the array we send */
  return elem1 === elem2;
};

foo1.same(foo2);             /* Returns true*/
foo1.same(foo2, check);      /* Returns true*/

foo2.push(2);

foo1.same(foo2);             /* Returns false*/
foo1.same(foo2, check);      /* Returns false*/

Usage:

var foo1 = [1,3,5,7,9];
var foo2 = [1,3,5];
var foo3 = [1,6];

var check = function(elem1, elem2){      /* elem1 is the array element and elem2 the element of the array we send */
  return elem1 === elem2;
};

foo1.hasList(foo2);             /* Returns true*/
foo1.hasList(foo2, check);      /* Returns true*/

foo1.hasList(foo3);             /* Returns false*/

Usage:

var foo1 = [1,3,5,7];
var foo2 = foo1.copy();

foo1 == foo2  /* Returns false */

Usage:

var foo = [2,4,6,8,0];

foo.sublist(1,3);            /* Returns [4, 6, 8]*/

Usage:

var foo = [1,3,5,7];

foo.shove(9);   /* Returns 5 and foo is [1,3,5,9] */
foo.shove(9);   /* Returns 5 and foo is [1,3,5,9] */

/* With comparison function */

var foo = [{a: 1, b: 2}];

var check = function(elem, value) {     /* elem is the array element and value the value we send */
  return elem.a === value.a;
};

foo.shove({a:3, b:4}, check);  /* Returns 2 and foo is [{a: 1, b: 2}, {a:3, b:4}] */
foo.shove({a:3, b:4}, check):  /* Returns 2 and foo is [{a: 1, b: 2}, {a:3, b:4}] */

Usage:

var foo = [1,5,9];

foo.insert(3,2));      /* Returns 4 and foo is [1,5,3,9] */

Usage:

var foo = [1,3,5,7,9];

foo.remove(3));      /* Returns 4 and foo is [1,5,3,9] */

Usage:

var foo = [0,1,2,null,"hello",""];

foo.clean();        /* foo is [0,1,2,"hello"] */

Usage:

var foo1 = [1,3,5,7,9];
var foo2 = [1,2,5,6,9];

foo1.intersection(foo2);      /* Returns [1,5,9] */

var foo3 = [{a: 1, b:2}, {a: 3, b: 4}];
var foo4 = [{a: 1, b:2}];

var check = function(elem1, elem2){     /* elem1 is the array element and elem2 the element of the array we send */
  elem1.a == elem2.a
};

foo3.intersection(foo4, check);      /* Returns [{a: 1, b:2}] */

Usage:

var foo1 = [1,3,5,7,9];
var foo2 = [5,9];

foo1.deduct(foo2);      /* Returns [1,3,7] */

var foo3 = [{a: 1, b:2}, {a: 3, b: 4}];
var foo4 = [{a: 1, b:2}];

var check = function(elem1, elem2){     /* elem1 is the array element and elem2 the element of the array we send */
  elem1.a == elem2.a
};

foo3.deduct(foo4, check);      /* Returns [{a: 3, b:4}] */

Usage:

var foo1 = [1,3,5,7,9];
var foo2 = [2,4,5,6,8,9];

foo1.merge(foo2);      /* Returns [1,3,5,7,9,2,4,6,8] */

var foo3 = [{a: 1, b:2}, {a: 3, b: 4}];
var foo4 = [{a: 1, b:2}, {a: 5, b:6}];

var check = function(elem1, elem2){     /* elem1 is the array element and elem2 the element of the array we send */
  elem1.a == elem2.a
};

foo3.merge(foo4, check);      /* Returns [{a: 1, b:2}, {a: 3, b:4}, {a: 5, b:6}] */

Usage:

var aFoo = [1,3,5,7,9];
var sFoo = "hello array";

Array.isArray(aFoo);    /* Returns true */
Array.isArray(sFoo);    /* Returns false */