-
Notifications
You must be signed in to change notification settings - Fork 8
/
reverse.php
36 lines (30 loc) · 1000 Bytes
/
reverse.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<?php
namespace Dash;
/**
* Gets a new array of `$iterable` elements in reverse order.
*
* @param iterable|stdClass|null $iterable
* @param boolean $preserveIntegerKeys (optional) If true, integer keys will be preserved;
* non-integer keys are always preserved regardless of this setting
* @return array New array of `$iterable` elements in reverse order
*
* @example
Dash\reverse(['a', 'b', 'c']);
// === ['c', 'b', 'a']
Dash\reverse(['a' => 1, 'b' => 2, 'c' => 3]);
// === ['c' => 3, 'b' => 2, 'a' => 1]
*
* @example Preserving integer keys
Dash\reverse(['a', 'b', 'c'], true);
// === [2 => 'c', 1 => 'b', 0 => 'a']
Dash\reverse(['a', 'b', 'c'], false);
// === [0 => 'c', 1 => 'b', 2 => 'a']
*/
function reverse($iterable, $preserveIntegerKeys = false)
{
assertType($iterable, ['iterable', 'stdClass', 'null'], __FUNCTION__);
if (is_null($iterable)) {
return [];
}
return array_reverse(toArray($iterable), $preserveIntegerKeys);
}