Arrays

Available methods

• Informations about an array
  • average
  • contains
  • matches
  • matchesAny
  • size
  • sum
• Get from an array
  • find
  • first
  • get
  • last
  • pluck
• Act upon an array
  • at
• Alter an array
  • each
  • filter
  • reject
  • invoke

---

Informations about an array

Arrays::average

Computes the average value of an array

Arrays::average(array(1, 2, 3)) // Returns 2

Arrays::contains

Check if an item is in an array

Arrays::contains(array(1, 2, 3), 2) // Returns true

Arrays::matches

Check if all items in an array match a truth test

Arrays::matches(array(1, 2, 3), function($value) {
    return $value % 2 == 0; // Returns false
});

Arrays::matchesAny

Same than above but returns true if at least one item matches

Arrays::matchesAny(array(1, 2, 3), function($value) {
    return $value % 2 == 0; // Returns true
});

Arrays::size

Get the size of an array

Arrays::size(array(1, 2, 3)) // Returns 3

Arrays::sum

Computes the sum of an array

Arrays::sum(array(1, 2, 3)) // Returns 6

---

Get from an array

Arrays::find

Find the first value in an array that passes a truth test

Arrays::find(array(1, 2, 3), function($value) {
    return $value % 2 == 0; // Returns 2
});

Arrays::first

Get the first value from an array

Arrays::first(array(1, 2, 3)) // Returns 1

Arrays::last

Get the last value from an array

Arrays::last(array(1, 2, 3)) // Returns 3

Arrays::get

Get a value from an array using dot-notation

$array = underscore(array('foo' => array('bar' => 'ter')));
$array->get('foo.bar') // Return 'ter'

Arrays::pluck

Pluck a column from an array

$array = array(
    array('foo' => 'bar', 'bis' => 'ter'),
    array('foo' => 'bar', 'bis' => 'ter'),
);
Arrays::pluck($array, 'foo'); // Returns array('bar', 'bar')

---

Act upon an array

Arrays::at

Iterate over an array to execute a callback at each loop

$multiplier = 3;
Arrays::each(array(1, 2, 3), function($value) use ($multiplier) {
    echo $value * $multiplier; // Prints out 3, 6, 9
});

---

Alter an array

Arrays::each

Iterate over an array and apply a callback to each value

Arrays::map(array(1, 2, 3), function($value) {
    return $value * 3; // Return array(3, 6, 9)
});

Arrays::filter

Find all values in an array that passes a truth test

Arrays::filter(array(1, 2, 3), function($value) {
    return $value % 2 != 0; // Returns array(1, 3)
});

Arrays::reject

Find all values in an array that are rejected by a truth test

Arrays::filter(array(1, 2, 3), function($value) {
    return $value % 2 != 0; // Returns array(2)
});

Arrays::invoke

Invoke a function on all of an array's values

Arrays::invoke(array('   foo'), 'trim'); // Returns array('foo')