## array_add 如果給定的鍵不在數組中，array_add 函數會把給定的鍵值對加到數組中。 ~~~ $array = ['foo' => 'bar']; $array = array_add($array, 'key', 'value'); ~~~ ## array_divide array_divide 函數返回兩個數組，一個包含原本數組的鍵，另一個包含原本數組的值。 ~~~ $array = ['foo' => 'bar']; list($keys, $values) = array_divide($array); ~~~ ## array_dot array_dot 函數把多維數組扁平化成一維數組，并用「點」符號表示深度。 ~~~ $array = ['foo' => ['bar' => 'baz']]; $array = array_dot($array); // ['foo.bar' => 'baz']; ~~~ ## array_except array_except 函數從數組移除給定的鍵值對。 `$array = array_except($array, ['keys', 'to', 'remove']);` ## array_fetch array_fetch 函數返回包含被選擇的嵌套元素的扁平化數組。 ~~~ $array = [ ['developer' => ['name' => 'Taylor']], ['developer' => ['name' => 'Dayle']] ]; $array = array_fetch($array, 'developer.name'); // ['Taylor', 'Dayle']; ~~~ ## array_first array_first 函數返回數組中第一個通過給定的測試為真的元素。 ~~~ $array = [100, 200, 300]; $value = array_first($array, function($key, $value) { return $value >= 150; }); ~~~ 也可以傳遞默認值當作第三個參數： `$value = array_first($array, $callback, $default);` ## array_last array_last 函數返回數組中最后一個通過給定的測試為真的元素。 ~~~ $array = [350, 400, 500, 300, 200, 100]; $value = array_last($array, function($key, $value) { return $value > 350; }); // 500 ~~~ 也可以傳遞默認值當作第三個參數： `$value = array_last($array, $callback, $default);` ## array_flatten array_flatten 函數將會把多維數組扁平化成一維。 ~~~ $array = ['name' => 'Joe', 'languages' => ['PHP', 'Ruby']]; $array = array_flatten($array); // ['Joe', 'PHP', 'Ruby']; ~~~ ## array_forget array_forget 函數將會用「點」符號從深度嵌套數組移除給定的鍵值對。 ~~~ $array = ['names' => ['joe' => ['programmer']]]; array_forget($array, 'names.joe'); ~~~ ## array_get array_get 函數將會使用「點」符號從深度嵌套數組取回給定的值。 ~~~ $array = ['names' => ['joe' => ['programmer']]]; $value = array_get($array, 'names.joe'); $value = array_get($array, 'names.john', 'default'); ~~~ > 注意: 想要把 array_get 用在對象上？ 請使用 object_get。 ## array_only array_only 函數將會只從數組返回給定的鍵值對。 ~~~ $array = ['name' => 'Joe', 'age' => 27, 'votes' => 1]; $array = array_only($array, ['name', 'votes']); ~~~ ## array_pluck array_pluck 函數將會從數組拉出給定鍵值對的清單。 ~~~ $array = [['name' => 'Taylor'], ['name' => 'Dayle']]; $array = array_pluck($array, 'name'); // ['Taylor', 'Dayle']; ~~~ ## array_pull array_pull 函數將會從數組返回給定的鍵值對，并移除它。 ~~~ $array = ['name' => 'Taylor', 'age' => 27]; $name = array_pull($array, 'name'); ~~~ ## array_set array_set 函數將會使用「點」符號在深度嵌套數組中指定值。 ~~~ $array = ['names' => ['programmer' => 'Joe']]; array_set($array, 'names.editor', 'Taylor'); ~~~ ## array_sort array_sort 函數通過給定閉包的結果來排序數組。 ~~~ $array = [ ['name' => 'Jill'], ['name' => 'Barry'] ]; $array = array_values(array_sort($array, function($value) { return $value['name']; })); ~~~ ## array_where 使用給定的閉包過濾數組。 ~~~ $array = [100, '200', 300, '400', 500]; $array = array_where($array, function($key, $value) { return is_string($value); }); // Array ( [1] => 200 [3] => 400 ) ~~~ ## head 返回數組中第一個元素 `$first = head($this->returnsArray('foo'));` ## last 返回數組中最后一個元素。對方法鏈很有用。 `$last = last($this->returnsArray('foo'));`