tzlib v1.0.14

What is tzlib ?

It provides extension methods on javascript Array. 
Some methods are replica of linq in .Net (C#).

Function Documentation :

first()

Returns first elements of an array.

function first() {
    let numArray = new Array<number>();
        numArray.push(3);
        numArray.push(100);
        numArray.push(2);
        numArray.push(10);
        numArray.push(4);
  console.log(numArray.first());  // This will print 3

}

### *last()*
___
> Returns last elements of an array.
```javascript
function last() {
    let numArray = new Array<number>();
        numArray.push(3);
        numArray.push(100);
        numArray.push(2);
        numArray.push(10);
        numArray.push(4);
  console.log(numArray.last());  // This will print 4

}

clear()

Remove all elements from an array.

function clear() {
    let numArray = new Array<number>();
        numArray.push(3);
        numArray.push(100);
        numArray.push(2);
        numArray.push(10);
        numArray.push(4);
  console.log(numArray.clear());  // This will print []

}

### *where(predicate)*
___
> Returns subset of source Array that satisfies predicate.
```javascript
function where() {
    let numArray = new Array<number>();
        numArray.push(3);
        numArray.push(100);
        numArray.push(2);
        numArray.push(10);
        numArray.push(4);
  console.log(numArray.where(ele => ele > 10));  // This will print 100
  console.log(numArray.where(ele => ele === 3)); // This will print 3

}

addRange()

Returns Array which is superset of two arrays.

function addRange() {
    let numArray = new Array<number>();
        numArray.push(3);
        numArray.push(100);
        numArray.push(2);
        numArray.push(10);
        numArray.push(4);

const augArray = [5,6,];

console.log(numArray.addRange(augArray)); // This will print 3,100,2,10,4,5,6

}

### *removeRange()*
___
> Returns first elements of an array.
```javascript
function removeRange() {
    let numArray = new Array<number>();
        numArray.push(3);
        numArray.push(100);
        numArray.push(2);
        numArray.push(10);
        numArray.push(4);

  console.log(numArray.removeRange(2,2));  // This will print 2,10

}

strictSort()

Sorts array for both number & String.

function strictSort() {
    let sArray = new Array<number>();
        sArray.push('IronMan');
        sArray.push('Thor');
        sArray.push('Captain America');
        sArray.push('Hulk');

console.log(numArray.strictSort);

// This will print : Captain America, Hulk, IronMan, Thor

let numArray = new Array(); numArray.push(3); numArray.push(100); numArray.push(2); numArray.push(10); numArray.push(4);

console.log(numArray.strictSort);
// This will print : 2,3,4,10,100

}

### *orderBy(property,sortOrder?)*
___
> Returns sorted Array of objects determined by key.
> User has an option to select either asceding or descending order.
```javascript
function orderBy(expression,sortOrder) {
    let sArray = new Array<number>();
        sArray=  [{ Name: 'Tony Stark', Alias: 'Iron Man' }, { Name: 'Robert Bruce Banner', Alias: 'Hulk' },
                  { Name: 'Steve Rojer', Alias: 'Captain America' }, { Name: 'Natasha Romanova', Alias: 'Black Widow' }];
  
  console.log(numArray.orderBy(item=>item.Name));  // Will sort array by Name property in Asc order
  console.log(numArray.orderBy(item=>item.Alias),false);  // Will sort array by Alias property in Desc order
}

insertAt(item,position)

Insert element at mentioned position.

function insertAt() {
    let numArray = new Array<number>();
        numArray.push(3);
        numArray.push(100);
        numArray.push(2);
        numArray.push(10);
        numArray.push(4);

console.log(numArray.insertAt(50,0,1)); // Will insert 50 at array index 1, print 3, 50, 100, 2, 10, 4 }

### *getMatchCount(predicate)*
___
> Returns count of number of matching element.
```javascript
function getcount() {
    let numArray = new Array<number>();
        numArray.push(3);
        numArray.push(100);
        numArray.push(3);
        numArray.push(10);
        numArray.push(2);
  
  console.log(numArray.getMatchCount(ele=>ele===3));  // Will return 2.
}