arr 

> JavaScript utilities for arrays.

Install

Install with npm:

``bash
npm i arr --save-dev
`

Usage

`js
var utils = require('arr');
`

API

$3

Filter array, returning only the values of the given type.

* array {Array}
* type {String}: Native type, e.g. string, object
* returns: {Boolean}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];

utils.filterType(arr, 'object');
//=> [{a: 'b'}, {c: 'd'}]
`

$3

Return the first index of the given type, or -1 if not found.

* array {Array}
* type {String}: Native type, e.g. string, object
* returns: {Boolean}

`js
utils.firstIndex(['a', 1, 'b', 2, {c: 'd'}, 'c'], 'object');
//=> 4
`

$3

Return the first index of the given type, or -1 if not found.

* array {Array}
* type {String}: Native type, e.g. string, object
* returns: {Boolean}

`js
utils.firstIndex(['a', 1, 'b', 2, {c: 'd'}, 'c'], 'object');
//=> 4
`

$3

Return the first index of the given type, or -1 if not found.

* array {Array}
* type {String}: Native type, e.g. string, object
* returns: {Boolean}

`js
utils.firstIndex(['a', 1, 'b', 2, {c: 'd'}, 'c'], 'object');
//=> 4
`

$3

Return the first index of the given type, or -1 if not found.

* array {Array}
* type {String}: Native type, e.g. string, object
* returns: {Boolean}

`js
utils.firstIndex(['a', 1, 'b', 2, {c: 'd'}, 'c'], 'object');
//=> 4
`

$3

Filter array, returning only the numbers.

* array {Array}
* index {Array}: Optionally specify the index of the number to return, otherwise all numbers are returned.
* returns {Array}: Array of numbers or empty array.

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];

utils.numbers(arr);
//=> [1, 2]
`

$3

Filter array, returning only the numbers.

* array {Array}
* index {Array}: Optionally specify the index of the number to return, otherwise all numbers are returned.
* returns {Array}: Array of numbers or empty array.

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];

utils.numbers(arr);
//=> [1, 2]
`

$3

Filter array, returning only the strings.

* array {Array}
* index {Array}: Optionally specify the index of the string to return, otherwise all strings are returned.
* returns {Array}: Array of strings or empty array.

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];

utils.strings(arr);
//=> ['a', 'b', 'c']
`

$3

Filter array, returning only the objects.

* array {Array}
* index {Array}: Optionally specify the index of the object to return, otherwise all objects are returned.
* returns {Array}: Array of objects or empty array.

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];

utils.objects(arr);
//=> [{a: 'b'}, {c: 'd'}]
`

$3

Filter array, returning only the functions.

* array {Array}
* index {Array}: Optionally specify the index of the function to return, otherwise all functions are returned.
* returns {Array}: Array of functions or empty array.

`js
var one = function() {};
var two = function() {};
var arr = ['a', {a: 'b'}, 1, one, 'b', 2, {c: 'd'}, two, 'c'];

utils.functions(arr);
//=> [one, two]
`

$3

Filter array, returning only the arrays.

* array {Array}
* index {Array}: Optionally specify the index of the array to return, otherwise all arrays are returned.
* returns {Array}: Array of arrays or empty array.

`js
var arr = ['a', ['aaa'], 1, 'b', ['bbb'], 2, {c: 'd'}, 'c'];

utils.objects(arr);
//=> [['aaa'], ['bbb']]
`

$3

Return the first element in array, or, if a callback is passed, return the first value for which the returns true.

* array {Array}
returns: {}

`js
var arr = ['a', {a: 'b'}, 1, one, 'b', 2, {c: 'd'}, two, 'c'];

utils.first(arr);
//=> 'a'

utils.first(arr, isType('object'));
//=> {a: 'b'}

utils.first(arr, 'object');
//=> {a: 'b'}
`

$3

Return the last element in array, or, if a callback is passed, return the last value for which the returns true.

* array {Array}
returns: {}

`js
// one and two are functions
var arr = ['a', {a: 'b'}, 1, one, 'b', 2, {c: 'd'}, two, 'c'];

utils.last(arr);
//=> 'c'

utils.last(arr, isType('function'));
//=> two

utils.last(arr, 'object');
//=> {c: 'd'}
`

$3

Get the last element in array of the given type.

* array {Array}
* type {String}: The native type to get.
returns: {}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
lastOfType(arr, 'number');
//=> 2
`

$3

Get the first element in array of the given type.

* array {Array}
* type {String}: The native type to get.
returns: {}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
firstOfType(arr, 'number');
//=> 1
`

$3

Returns true if the last element in array is the given type.

* array {Array}
* type {String}: The native type to check.
* returns: {Boolean}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
lastIsType(arr, 'number');
//=> false
`

$3

Returns true if the first element in array is the given type.

* array {Array}
* type {String}: The native type to check.
* returns: {Boolean}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
firstIsType(arr, 'string');
//=> true
`

$3

Get the first string in array.

* array {Array}
* returns: {String}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
firstString(arr, 'string');
//=> 'a'
`

$3

Get the last string in array.

* array {Array}
* returns: {String}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
lastString(arr, 'string');
//=> 'c'
`

$3

Get the first function in array.

* array {Array}
* returns: {Function}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
firstFunction(arr, 'function');
//=> 'a'
`

$3

Get the last function in array.

* array {Array}
* returns: {Function}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
lastFunction(arr, 'function');
//=> 'a'
`

$3

Get the first number in array.

* array {Array}
* returns: {Function}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
firstNumber(arr, 'number');
//=> '1'
`

$3

Get the last number in array.

* array {Array}
* returns: {Function}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
lastNumber(arr, 'number');
//=> '2'
`

$3

Get the first object in array.

* array {Array}
* returns: {Object}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
firstObject(arr);
//=> {a: 'b'}
`

$3

Get the last object in array.

* array {Array}
* returns: {Object}

`js
var arr = ['a', {a: 'b'}, 1, 'b', 2, {c: 'd'}, 'c'];
lastObject(arr);
//=> {c: 'd'}
``

Author

Jon Schlinkert

+ github/jonschlinkert
+ twitter/jonschlinkert

$3

Other projects that I maintain:

- assemble
- verb
- less.js
- handlebars-helpers
- arr
- arr-diff
- array-last
- array-slice
- array-sum
- arrayify-compact
- compact-object
- delete
- for-in
- for-own
- has-any
- has-value
- is-number
- is-plain-object
- mixin-deep
- mixin-object
- object-length
- omit-empty
- reduce-object

License

Copyright (c) 2014 Jon Schlinkert, contributors.
Released under the MIT license

*

_This file was generated by verb-cli on November 03, 2014._