====== Filters ======
Sometimes it is necessary to filter out some elements.

===== [ n ] =====
Gets the n<sup>th</sup> element that are current contained in that instance of Karmagination object. The returned element will lose access to Karmagination's method.

<code html>
<div>One</div>
<div>Two</div>
<div>Three</div>
</code>
<code javascript>
alert(Karma('div')[0].innerHTML); // One
alert(Karma('div')[1].innerHTML); // Two
alert(Karma('div')[2].innerHTML); // Three
</code>

===== length =====
Represents the number of elements that are current contained in that instance of Karmagination object.

<code html>
<div>One</div>
<div>Two</div>
<div>Three</div>
</code>
<code javascript>
alert(Karma('div').length); // 3
</code>

===== get( ) =====
Returns all the elements contained in the Karmagination object as an array. In other words, this method strips the Karmagination object wrapper and returns a true array containing all of the elements.

<code html>
<div>A</div>
<div>B</div>
<div>C</div>
</code>
<code javascript>
alert (Karma('div') instanceof Array);       // false
alert (Karma('div').length);                 // 3
alert (Karma('div').get() instanceof Array); // true
alert (Karma('div').get().length);           // 3
</code>

===== index( selector ) =====
Returns the index (starting from 0) of the first element that matches the first element returned by the selector. If there are no matches, -1 is returned

<code html>
<div id="find">index 0</div>
<div>index 1</div>
<div id="wanted">index 2</div>
<div>index 3</div>
</code>
<code javascript>
alert(Karma('div').index('#find'));   // 0
alert(Karma('div').index('#wanted')); // 2
alert(Karma('div').index('#notfound')); // -1
</code>

===== index( element ) =====
Returns the index (starting from 0) of the first element that matches the element. If there are no matches, -1 is returned

<code html>
<span id="notfound">LOL</span>
<div id="find">index 0</div>
<div>index 1</div>
<div id="wanted">index 2</div>
<div>index 3</div>
</code>
<code javascript>
alert(Karma('div').index(document.getElementById('find'));     // 0
alert(Karma('div').index(document.getElementById('wanted'));   // 2
alert(Karma('div').index(document.getElementById('notfound')); // -1 because notfound is <SPAN>
</code>

===== eq( n ) =====
Gets the n<sup>th</sup> element and return the object wrapped in Karmagination. This method is chainable.

<code html>
<div>A</div>
<div>B</div>
<div>C</div>
</code>
<code javascript>
alert(Karma('div').length);             // 3
alert(Karma('div').eq(0).length);       // 1
alert(Karma('div').eq(0)[0].innerHTML); // A
alert(Karma('div').eq(0).end().length); // 3
</code>

===== slice( start, [end] ) =====
Gets the elements from the start index till end index. If end is not specified, then the method will get till the last element. Returns the elements wrapped in Karmagination. This method is chainable.

<code html>
<div>One</div>
<div>Two</div>
<div>Three</div>
</code>
<code javascript>
alert(Karma('div').length);                // 3, elements contained are [ <div>One</div>, <div>Two</div>, <div>Three</div> ]
alert(Karma('div').slice(1).length);       // 2, elements contained are [ <div>Two</div>, <div>Three</div> ]
alert(Karma('div').slice(1).end().length); // 3, elements contained are [ <div>One</div>, <div>Two</div>, <div>Three</div> ]
</code>

===== filter( selector ) =====
Removes all element that does not match the selector

<code html>
<div>a</div>
<div>b</div>
<span>c</span>
</code>
<code javascript>
alert(Karma('*').filter('span').length); // 2
alert(Karma('*').filter('span').get());  // [ <div>a</div>, <div>b</div> ]
</code>

===== grep( callback ) =====
Goes through all the elements and grabs those elements that meet a certain criteria. Returns the Karmagination object. This method is chainable.

<code html>
<div>100</div>
<div>1000</div>
<div>10000</div>
</code>
<code javascript>
var metCriteria = Karma('div').grep(function(el, i){
  return parseInt(el.innerHTML) > 500;
});

alert(metCriteria.get()); // [ <div>1000</div>, <div>10000</div> ]
</code>

===== is( selector ) =====
Returns true is one of the elements matches the expression

===== not( selector ) =====
Removes elements that do not match the selector