1
|
|
|
<?php |
2
|
|
|
namespace Spindle\Collection\Traits; |
3
|
|
|
|
4
|
|
|
trait SortTrait |
5
|
|
|
{ |
6
|
|
|
/** |
7
|
|
|
* @return \Spindle\Collection\Collection (new instance) |
8
|
|
|
*/ |
9
|
1 |
|
public function usort(callable $cmp) |
10
|
|
|
{ |
11
|
1 |
|
$array = $this->toArray(); |
|
|
|
|
12
|
1 |
|
usort($array, $cmp); |
13
|
1 |
|
return new $this($array, $this->debug); |
|
|
|
|
14
|
|
|
} |
15
|
|
|
|
16
|
|
|
/** |
17
|
|
|
* @param int $sort_flags \SORT_REGULAR|\SORT_NUMERIC|\SORT_STRING |
18
|
|
|
* @return \Spindle\Collection\Collection (new instance) |
19
|
|
|
*/ |
20
|
1 |
|
public function rsort($sort_flags = \SORT_REGULAR) |
21
|
|
|
{ |
22
|
1 |
|
$array = $this->toArray(); |
|
|
|
|
23
|
1 |
|
rsort($array, $sort_flags); |
24
|
1 |
|
return new $this($array, $this->debug); |
25
|
|
|
} |
26
|
|
|
|
27
|
|
|
/** |
28
|
|
|
* @param int $sort_flags \SORT_REGULAR|\SORT_NUMERIC|\SORT_STRING |
29
|
|
|
* @return \Spindle\Collection\Collection (new instance) |
30
|
|
|
*/ |
31
|
1 |
|
public function sort($sort_flags = \SORT_REGULAR) |
32
|
|
|
{ |
33
|
1 |
|
$array = $this->toArray(); |
|
|
|
|
34
|
1 |
|
sort($array, $sort_flags); |
35
|
1 |
|
return new $this($array, $this->debug); |
36
|
|
|
} |
37
|
|
|
|
38
|
|
|
/** |
39
|
|
|
* stable sort |
40
|
|
|
* @return \Spindle\Collection\Collection (new instance) |
41
|
|
|
*/ |
42
|
1 |
|
public function usortStable(callable $cmp) |
43
|
|
|
{ |
44
|
1 |
|
$array = $this->map('[$_, $_i]')->toArray(); |
|
|
|
|
45
|
1 |
|
usort($array, static function ($a, $b) use ($cmp) { |
46
|
1 |
|
return $cmp($a[0], $b[0]) ?: ($a[1] - $b[1]); |
47
|
1 |
|
}); |
48
|
1 |
|
$sorted = new $this($array, $this->debug); |
49
|
1 |
|
$sorted->column(0)->toArray(); |
50
|
1 |
|
return $sorted; |
51
|
|
|
} |
52
|
|
|
|
53
|
|
|
/** |
54
|
|
|
* sort with Schwartzian Transform |
55
|
|
|
* @param string|callable $fn map function |
56
|
|
|
* @param SORT_ASC|SORT_DESC $sort_order |
57
|
|
|
* @param SORT_REGULAR|SORT_NUMERIC|SORT_STRING $sort_flags |
58
|
|
|
* @return \Spindle\Collection (new instance) |
59
|
|
|
*/ |
60
|
1 |
|
public function mapSort($fn, $sort_order = \SORT_ASC, $sort_flags = \SORT_REGULAR) |
61
|
|
|
{ |
62
|
1 |
|
$array = $this->toArray(); |
|
|
|
|
63
|
1 |
|
$mapped = (new static($array))->map($fn)->toArray(); |
|
|
|
|
64
|
1 |
|
array_multisort($mapped, $sort_order, $sort_flags, $array); |
65
|
1 |
|
return new $this($array, $this->debug); |
66
|
|
|
} |
67
|
|
|
} |
68
|
|
|
|
This check looks for methods that are used by a trait but not required by it.
To illustrate, let’s look at the following code example
The trait
Idable
provides a methodequalsId
that in turn relies on the methodgetId()
. If this method does not exist on a class mixing in this trait, the method will fail.Adding the
getId()
as an abstract method to the trait will make sure it is available.