|
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
Idableprovides a methodequalsIdthat 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.