Completed
Pull Request — master (#7)
by ARCANEDEV
12:42
created

Distance::defaultNames()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 12
Code Lines 9

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 3
CRAP Score 1

Importance

Changes 1
Bugs 0 Features 0
Metric Value
c 1
b 0
f 0
dl 0
loc 12
ccs 3
cts 3
cp 1
rs 9.4285
cc 1
eloc 9
nc 1
nop 0
crap 1
1
<?php namespace Arcanedev\Units\Measures;
2
3
use Arcanedev\Units\Bases\UnitMeasure;
4
use Arcanedev\Units\Contracts\Measures\Distance as DistanceContract;
5
use Arcanedev\Units\Traits\Calculatable;
6
7
/**
8
 * Class     Distance
9
 *
10
 * @package  Arcanedev\Units\Measures
11
 * @author   ARCANEDEV <[email protected]>
12
 */
13
class Distance extends UnitMeasure implements DistanceContract
14
{
15
    /* ------------------------------------------------------------------------------------------------
16
     |  Traits
17
     | ------------------------------------------------------------------------------------------------
18
     */
19
    use Calculatable;
20
21
    /* ------------------------------------------------------------------------------------------------
22
     |  Constructor
23
     | ------------------------------------------------------------------------------------------------
24
     */
25
    /**
26
     * Distance constructor.
27
     *
28
     * @param  float|int  $value
29
     * @param  string     $unit
30
     * @param  array      $options
31
     */
32
    public function __construct($value = 0, $unit = self::M, array $options = [])
33 176
    {
34
        $this->init($value, $unit, $options);
35 176
    }
36 176
37 176
    /* ------------------------------------------------------------------------------------------------
38 176
     |  Getters & Setters
39 176
     | ------------------------------------------------------------------------------------------------
40 176
     */
41 176
    /**
42 132
     * Get the default names.
43 176
     *
44
     * @return array
45
     */
46
    public function defaultNames()
47
    {
48
        return array_combine(static::units(), [
49
            'kilometer',
50
            'hectometre',
51
            'decametre',
52
            'metre',
53
            'decimetre',
54 8
            'centimetre',
55
            'millimetre',
56 8
        ]);
57 8
    }
58 6
59 6
    /* ------------------------------------------------------------------------------------------------
60 6
     |  Main Functions
61 6
     | ------------------------------------------------------------------------------------------------
62 6
     */
63 6
    /**
64 6
     * Make a distance instance.
65
     *
66
     * @param  float|int  $value
67
     * @param  string     $unit
68
     * @param  array      $options
69
     *
70
     * @return static
71
     */
72
    public static function make($value = 0, $unit = self::M, array $options = [])
73
    {
74 8
        return new static($value, $unit, $options);
75
    }
76 8
77
    /**
78 8
     * Convert the distance to the given unit.
79
     *
80
     * @param  string  $to
81
     *
82
     * @return \Arcanedev\Units\Contracts\Measures\Distance
83
     */
84
    public function to($to)
85
    {
86
        if ($to === $this->unit()) return $this;
87
88
        $value = static::convert($this->unit(), $to, $this->value());
89
90
        return static::make($value, $to);
91
    }
92
93
    /**
94 72
     * Convert the distance.
95
     *
96 72
     * @param  string     $from
97
     * @param  string     $to
98
     * @param  float|int  $value
99
     *
100
     * @return float|int
101
     */
102
    public static function convert($from, $to, $value)
103
    {
104
        return $value * static::getRatio($to, $from);
105
    }
106 72
107
    /* ------------------------------------------------------------------------------------------------
108 72
     |  Calculation Functions
109
     | ------------------------------------------------------------------------------------------------
110 24
     */
111
    /**
112 24
     * Add the distance.
113
     *
114
     * @param  float|int  $value
115
     * @param  string     $unit
116
     *
117
     * @return \Arcanedev\Units\Contracts\Measures\Distance
118
     */
119
    public function addDistance($value, $unit = self::M)
120
    {
121
        return $this->add(
122
            self::make($value, $unit)
123
        );
124 24
    }
125
126 24
    /**
127
     * Sub the distance.
128
     *
129
     * @param  float|int  $value
130
     * @param  string     $unit
131
     *
132
     * @return \Arcanedev\Units\Contracts\Measures\Distance
133
     */
134
    public function subDistance($value, $unit = self::M)
135
    {
136
        return $this->sub(
137
            static::make($value, $unit)
138
        );
139
    }
140
141 16
    /* ------------------------------------------------------------------------------------------------
142
     |  Other Functions
143 16
     | ------------------------------------------------------------------------------------------------
144 16
     */
145 12
    /**
146
     * Get the distance convert ratio.
147
     *
148
     * @param  string  $to
149
     * @param  string  $from
150
     *
151
     * @return float|int
152
     */
153
    protected static function getRatio($to, $from)
154
    {
155
        static::checkUnit($from);
156 16
        static::checkUnit($to);
157
158 16
        if ($to === $from) return 1;
159 16
160 12
        $ratios = static::getRatios();
161
162
        return $ratios[$to] / $ratios[$from];
163
    }
164
165
    /**
166
     * Get all the distance ratios.
167
     *
168
     * @return array
169
     */
170
    protected static function getRatios()
171
    {
172
        $rate   = 10;
173
        $ratios = [
174
            static::KM  => 0,
175 24
            static::HM  => 1,
176
            static::DAM => 2,
177 24
            static::M   => 3,
178 24
            static::DM  => 4,
179
            static::CM  => 5,
180 24
            static::MM  => 6,
181
        ];
182 24
183
        return array_map(function ($ratio) use ($rate) {
184 24
            return static::calculate($rate, '^', $ratio);
185
        }, $ratios);
186
    }
187
}
188