basic_temperature 0.2.1 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. checksums.yaml +4 -4
  2. data/.codeclimate.yml +33 -0
  3. data/.coveralls.yml +1 -0
  4. data/.gitignore +3 -0
  5. data/.rubocop.yml +12 -0
  6. data/.travis.yml +2 -1
  7. data/README.md +223 -9
  8. data/basic_temperature.gemspec +6 -1
  9. data/bin/console +4 -4
  10. data/docs/apple-touch-icon.png +0 -0
  11. data/docs/classes/BasicTemperature.html +1227 -0
  12. data/docs/classes/BasicTemperature/InitializationArgumentsError.html +94 -0
  13. data/docs/classes/BasicTemperature/InvalidDegreesError.html +94 -0
  14. data/docs/classes/BasicTemperature/InvalidNumericOrTemperatureError.html +94 -0
  15. data/docs/classes/BasicTemperature/InvalidScaleError.html +94 -0
  16. data/docs/classes/Object.html +274 -0
  17. data/docs/classes/Temperature.html +1227 -0
  18. data/docs/created.rid +4 -0
  19. data/docs/css/github.css +123 -0
  20. data/docs/css/main.css +374 -0
  21. data/docs/css/panel.css +361 -0
  22. data/docs/css/reset.css +48 -0
  23. data/docs/favicon.ico +0 -0
  24. data/docs/files/lib/basic_temperature/temperature_rb.html +73 -0
  25. data/docs/files/lib/basic_temperature/version_rb.html +84 -0
  26. data/docs/files/lib/basic_temperature_rb.html +112 -0
  27. data/docs/i/arrow-down.svg +8 -0
  28. data/docs/i/arrow-right.svg +8 -0
  29. data/docs/i/search.svg +12 -0
  30. data/docs/i/tree_bg.svg +8 -0
  31. data/docs/index.html +11 -0
  32. data/docs/js/highlight.pack.js +1 -0
  33. data/docs/js/jquery-1.3.2.min.js +19 -0
  34. data/docs/js/main.js +25 -0
  35. data/docs/js/navigation.js +105 -0
  36. data/docs/js/navigation.js.gz +0 -0
  37. data/docs/js/search_index.js +1 -0
  38. data/docs/js/search_index.js.gz +0 -0
  39. data/docs/js/searchdoc.js +465 -0
  40. data/docs/js/searcher.js +229 -0
  41. data/docs/js/searcher.js.gz +0 -0
  42. data/docs/panel/index.html +47 -0
  43. data/docs/panel/links.html +12 -0
  44. data/docs/panel/tree.js +1 -0
  45. data/lib/basic_temperature.rb +552 -75
  46. data/lib/basic_temperature/temperature.rb +5 -0
  47. data/lib/basic_temperature/version.rb +1 -1
  48. data/logo.png +0 -0
  49. metadata +112 -4
  50. data/Gemfile.lock +0 -54
data/docs/classes/Temperature.html ADDED
@@ -0,0 +1,1227 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <title>Temperature</title>
5
+ <meta charset="UTF-8" />
6
+ <link rel="stylesheet" href="../css/reset.css" type="text/css" media="screen" />
7
+ <link rel="stylesheet" href="../css/main.css" type="text/css" media="screen" />
8
+ <link rel="stylesheet" href="../css/github.css" type="text/css" media="screen" />
9
+ <script src="../js/jquery-1.3.2.min.js" type="text/javascript" charset="utf-8"></script>
10
+ <script src="../js/main.js" type="text/javascript" charset="utf-8"></script>
11
+ <script src="../js/highlight.pack.js" type="text/javascript" charset="utf-8"></script>
12
+
13
+
14
+ <meta property="og:title" value="Temperature">
15
+
16
+
17
+
18
+ <meta name="description" content="Temperature is a simple Value Object for basic temperature operations like conversions from Celsius to Fahrenhait or Kelvin etc. Supported scales: Celsius, Fahrenheit, Kelvin and Rankine.">
19
+ <meta property="og:description" content="Temperature is a simple Value Object for basic temperature operations like conversions from Celsius to Fahrenhait or Kelvin etc. Supported scales: Celsius, Fahrenheit, Kelvin and Rankine.">
20
+
21
+
22
+ <meta name="keywords" content="Temperature class">
23
+
24
+ <meta name="keywords" content="[], new, set_degrees, set_scale, to_scale, to_celsius, to_fahrenheit, to_kelvin, to_rankine, <=>, +, -, -@">
25
+
26
+ </head>
27
+
28
+ <body>
29
+ <div class="banner">
30
+
31
+ <h1>
32
+ <span class="type">Class</span>
33
+ Temperature
34
+
35
+ <span class="parent">&lt;
36
+
37
+ <a href="Object.html">Object</a>
38
+
39
+ </span>
40
+
41
+ </h1>
42
+ <ul class="files">
43
+
44
+ <li><a href="../files/lib/basic_temperature_rb.html">lib/basic_temperature.rb</a></li>
45
+
46
+ <li><a href="../files/lib/basic_temperature/version_rb.html">lib/basic_temperature/version.rb</a></li>
47
+
48
+ </ul>
49
+ </div>
50
+ <div id="bodyContent">
51
+ <div id="content">
52
+
53
+ <div class="description">
54
+
55
+ <p><a href="Temperature.html"><code>Temperature</code></a> is a simple <a href="https://martinfowler.com/bliki/ValueObject.html">Value Object</a> for basic temperature operations like conversions from <code>Celsius</code> to <code>Fahrenhait</code> or <code>Kelvin</code> etc.</p>
56
+
57
+ <p>Supported scales: <code>Celsius</code>, <code>Fahrenheit</code>, <code>Kelvin</code> and <code>Rankine</code>.</p>
58
+
59
+ <h2 id="class-Temperature-label-Creating+Temperatures">Creating Temperatures</h2>
60
+
61
+ <p>A new temperature can be created in multiple ways:</p>
62
+ <ul><li>
63
+ <p>Using keyword arguments:</p>
64
+
65
+ <pre><code>Temperature.new(degrees: 0, scale: :celsius)
66
+ </code></pre>
67
+ </li><li>
68
+ <p>Using positional arguments:</p>
69
+
70
+ <pre><code>Temperature.new(0, :celsius)
71
+ </code></pre>
72
+ </li><li>
73
+ <p>Even more concise way using <code>Temperature.[]</code> (an alias of <code>Temperature.new</code>):</p>
74
+
75
+ <pre><code>Temperature[0, :celsius]
76
+ </code></pre>
77
+ </li></ul>
78
+
79
+ <h2 id="class-Temperature-label-Creating+Temperatures+from+already+existing+temperature+objects">Creating Temperatures from already existing temperature objects</h2>
80
+
81
+ <p>Sometimes it is useful to create a new temperature from already existing one.</p>
82
+
83
+ <p>For such cases, there are <a href="BasicTemperature.html#method-i-set_scale">set_degrees}[rdoc-ref:BasicTemperature#set_degrees and {set_scale</a>.</p>
84
+
85
+ <p>Since temperatures are <a href="https://martinfowler.com/bliki/ValueObject.html">Value Objects</a>, both methods returns new instances.</p>
86
+
87
+ <p>Examples:</p>
88
+
89
+ <pre><code>temperature = Temperature[0, :celsius]
90
+ # =&gt; 0 °C
91
+
92
+ new_temperature = temperature.set_degrees(15)
93
+ # =&gt; 15 °C
94
+
95
+ temperature = Temperature[0, :celsius]
96
+ # =&gt; 0 °C
97
+
98
+ new_temperature = temperature.set_scale(:kelvin)
99
+ # =&gt; 0 K
100
+ </code></pre>
101
+
102
+ <h2 id="class-Temperature-label-Conversions">Conversions</h2>
103
+
104
+ <p>Temperatures can be converted to diffirent scales.</p>
105
+
106
+ <p>Currently, the following scales are supported: <code>Celsius</code>, <code>Fahrenheit</code>, <code>Kelvin</code> and <code>Rankine</code>.</p>
107
+
108
+ <pre><code>Temperature[20, :celsius].to_celsius
109
+ # =&gt; 20 °C
110
+
111
+ Temperature[20, :celsius].to_fahrenheit
112
+ # =&gt; 68 °F
113
+
114
+ Temperature[20, :celsius].to_kelvin
115
+ # =&gt; 293.15 K
116
+
117
+ Temperature[20, :celsius].to_rankine
118
+ # =&gt; 527.67 °R
119
+ </code></pre>
120
+
121
+ <p>If it is necessary to convert scale dynamically, <a href="BasicTemperature.html#method-i-to_scale">to_scale</a> method is available.</p>
122
+
123
+ <pre><code>Temperature[20, :celsius].to_scale(scale)
124
+ </code></pre>
125
+
126
+ <p>All conversion formulas are taken from <a href="https://www.rapidtables.com/convert/temperature/index.html">RapidTables</a>.</p>
127
+
128
+ <p>Conversion precision: 2 accurate digits after the decimal dot.</p>
129
+
130
+ <h2 id="class-Temperature-label-Comparison">Comparison</h2>
131
+
132
+ <p><a href="Temperature.html"><code>Temperature</code></a> implements idiomatic <a href="https://ruby-doc.org/core/Comparable.html"><=> spaceship operator</a> and mixes in <a href="https://ruby-doc.org/core/Comparable.html">Comparable</a> module.</p>
133
+
134
+ <p>As a result, all methods from Comparable are available, e.g:</p>
135
+
136
+ <pre><code>Temperature[20, :celsius] &lt; Temperature[25, :celsius]
137
+ # =&gt; true
138
+
139
+ Temperature[20, :celsius] &lt;= Temperature[25, :celsius]
140
+ # =&gt; true
141
+
142
+ Temperature[20, :celsius] == Temperature[25, :celsius]
143
+ # =&gt; false
144
+
145
+ Temperature[20, :celsius] &gt; Temperature[25, :celsius]
146
+ # =&gt; false
147
+
148
+ Temperature[20, :celsius] &gt;= Temperature[25, :celsius]
149
+ # =&gt; false
150
+
151
+ Temperature[20, :celsius].between?(Temperature[15, :celsius], Temperature[25, :celsius])
152
+ # =&gt; true
153
+
154
+ # Starting from Ruby 2.4.6
155
+ Temperature[20, :celsius].clamp(Temperature[20, :celsius], Temperature[25, :celsius])
156
+ # =&gt; 20 °C
157
+ </code></pre>
158
+
159
+ <p>Please note, if <code>other</code> temperature has a different scale, temperature is automatically converted to that scale before comparison.</p>
160
+
161
+ <pre><code>Temperature[20, :celsius] == Temperature[293.15, :kelvin]
162
+ # =&gt; true
163
+ </code></pre>
164
+
165
+ <p>IMPORTANT !!!</p>
166
+
167
+ <p><code>degrees</code> are rounded to the nearest value with a precision of 2 decimal digits before comparison.</p>
168
+
169
+ <p>This means the following temperatures are considered as equal:</p>
170
+
171
+ <pre><code>Temperature[20.020, :celsius] == Temperature[20.024, :celsius]
172
+ # =&gt; true
173
+
174
+ Temperature[20.025, :celsius] == Temperature[20.029, :celsius]
175
+ # =&gt; true
176
+ </code></pre>
177
+
178
+ <p>while these ones are treated as NOT equal:</p>
179
+
180
+ <pre><code>Temperature[20.024, :celsius] == Temperature[20.029, :celsius]
181
+ # =&gt; false
182
+ </code></pre>
183
+
184
+ <h2 id="class-Temperature-label-Math">Math</h2>
185
+
186
+ <h4 id="class-Temperature-label-Addition-2FSubtraction.">Addition/Subtraction.</h4>
187
+
188
+ <pre><code>Temperature[20, :celsius] + Temperature[10, :celsius]
189
+ # =&gt; 30 °C
190
+
191
+ Temperature[20, :celsius] - Temperature[10, :celsius]
192
+ # =&gt; 10 °C
193
+ </code></pre>
194
+
195
+ <p>If second temperature has a different scale, first temperature is automatically converted to that scale before <code>degrees</code> addition/subtraction.</p>
196
+
197
+ <pre><code>Temperature[283.15, :kelvin] + Temperature[10, :celsius]
198
+ # =&gt; 10 °C
199
+ </code></pre>
200
+
201
+ <p>Returned temperature will have the same scale as the second temperature.</p>
202
+
203
+ <p>It is possible to add/subtract numerics.</p>
204
+
205
+ <pre><code>Temperature[20, :celsius] + 10
206
+ # =&gt; 30 °C
207
+
208
+ Temperature[20, :celsius] - 10
209
+ # =&gt; 10 °C
210
+ </code></pre>
211
+
212
+ <p>In such cases, returned temperature will have the same scale as the first temperature.</p>
213
+
214
+ <p>Also <a href="https://ruby-doc.org/core/Numeric.html#method-i-coerce">Ruby coersion mechanism</a> is supported.</p>
215
+
216
+ <pre><code>10 + Temperature[20, :celsius]
217
+ # =&gt; 30 °C
218
+
219
+ 10 - Temperature[20, :celsius]
220
+ # =&gt; -10 °C
221
+ </code></pre>
222
+
223
+ <h4 id="class-Temperature-label-Negation">Negation</h4>
224
+
225
+ <pre><code>-Temperature[20, :celsius]
226
+ # =&gt; -20 °C
227
+ </code></pre>
228
+
229
+ </div>
230
+
231
+
232
+
233
+
234
+
235
+
236
+
237
+
238
+
239
+
240
+
241
+
242
+
243
+
244
+ <!-- Method ref -->
245
+ <div class="sectiontitle">Methods</div>
246
+ <dl class="methods">
247
+
248
+ <dt>#</dt>
249
+ <dd>
250
+ <ul>
251
+
252
+
253
+ <li>
254
+ <a href="#method-i-2B">+</a>,
255
+ </li>
256
+
257
+
258
+ <li>
259
+ <a href="#method-i-2D">-</a>,
260
+ </li>
261
+
262
+
263
+ <li>
264
+ <a href="#method-i-2D-40">-@</a>,
265
+ </li>
266
+
267
+
268
+ <li>
269
+ <a href="#method-i-3C-3D-3E">&lt;=&gt;</a>,
270
+ </li>
271
+
272
+
273
+ <li>
274
+ <a href="#method-c-5B-5D">[]</a>
275
+ </li>
276
+
277
+ </ul>
278
+ </dd>
279
+
280
+ <dt>N</dt>
281
+ <dd>
282
+ <ul>
283
+
284
+
285
+ <li>
286
+ <a href="#method-c-new">new</a>
287
+ </li>
288
+
289
+ </ul>
290
+ </dd>
291
+
292
+ <dt>S</dt>
293
+ <dd>
294
+ <ul>
295
+
296
+
297
+ <li>
298
+ <a href="#method-i-set_degrees">set_degrees</a>,
299
+ </li>
300
+
301
+
302
+ <li>
303
+ <a href="#method-i-set_scale">set_scale</a>
304
+ </li>
305
+
306
+ </ul>
307
+ </dd>
308
+
309
+ <dt>T</dt>
310
+ <dd>
311
+ <ul>
312
+
313
+
314
+ <li>
315
+ <a href="#method-i-to_celsius">to_celsius</a>,
316
+ </li>
317
+
318
+
319
+ <li>
320
+ <a href="#method-i-to_fahrenheit">to_fahrenheit</a>,
321
+ </li>
322
+
323
+
324
+ <li>
325
+ <a href="#method-i-to_kelvin">to_kelvin</a>,
326
+ </li>
327
+
328
+
329
+ <li>
330
+ <a href="#method-i-to_rankine">to_rankine</a>,
331
+ </li>
332
+
333
+
334
+ <li>
335
+ <a href="#method-i-to_scale">to_scale</a>
336
+ </li>
337
+
338
+ </ul>
339
+ </dd>
340
+
341
+ </dl>
342
+
343
+
344
+
345
+ <!-- Includes -->
346
+ <div class="sectiontitle">Included Modules</div>
347
+ <ul>
348
+
349
+ <li>
350
+
351
+ Comparable
352
+
353
+ </li>
354
+
355
+ </ul>
356
+
357
+
358
+
359
+
360
+
361
+
362
+
363
+
364
+
365
+
366
+
367
+ <!-- Section constants -->
368
+ <div class="sectiontitle">Constants</div>
369
+ <table border='0' cellpadding='5'>
370
+
371
+ <tr valign='top'>
372
+ <td class="attr-name">CELSIUS</td>
373
+ <td>=</td>
374
+ <td class="attr-value">&#39;celsius&#39;</td>
375
+ </tr>
376
+
377
+ <tr valign='top'>
378
+ <td>&nbsp;</td>
379
+ <td colspan="2" class="attr-desc"></td>
380
+ </tr>
381
+
382
+
383
+ <tr valign='top'>
384
+ <td class="attr-name">FAHRENHEIT</td>
385
+ <td>=</td>
386
+ <td class="attr-value">&#39;fahrenheit&#39;</td>
387
+ </tr>
388
+
389
+ <tr valign='top'>
390
+ <td>&nbsp;</td>
391
+ <td colspan="2" class="attr-desc"></td>
392
+ </tr>
393
+
394
+
395
+ <tr valign='top'>
396
+ <td class="attr-name">KELVIN</td>
397
+ <td>=</td>
398
+ <td class="attr-value">&#39;kelvin&#39;</td>
399
+ </tr>
400
+
401
+ <tr valign='top'>
402
+ <td>&nbsp;</td>
403
+ <td colspan="2" class="attr-desc"></td>
404
+ </tr>
405
+
406
+
407
+ <tr valign='top'>
408
+ <td class="attr-name">RANKINE</td>
409
+ <td>=</td>
410
+ <td class="attr-value">&#39;rankine&#39;</td>
411
+ </tr>
412
+
413
+ <tr valign='top'>
414
+ <td>&nbsp;</td>
415
+ <td colspan="2" class="attr-desc"></td>
416
+ </tr>
417
+
418
+
419
+ <tr valign='top'>
420
+ <td class="attr-name">SCALES</td>
421
+ <td>=</td>
422
+ <td class="attr-value">[CELSIUS, FAHRENHEIT, KELVIN, RANKINE].freeze</td>
423
+ </tr>
424
+
425
+ <tr valign='top'>
426
+ <td>&nbsp;</td>
427
+ <td colspan="2" class="attr-desc"><p>A list of all currently supported scale values.</p></td>
428
+ </tr>
429
+
430
+
431
+ <tr valign='top'>
432
+ <td class="attr-name">VERSION</td>
433
+ <td>=</td>
434
+ <td class="attr-value">&#39;0.2.1&#39;</td>
435
+ </tr>
436
+
437
+ <tr valign='top'>
438
+ <td>&nbsp;</td>
439
+ <td colspan="2" class="attr-desc"></td>
440
+ </tr>
441
+
442
+
443
+ </table>
444
+
445
+
446
+
447
+
448
+ <!-- Section attributes -->
449
+ <div class="sectiontitle">Attributes</div>
450
+ <table border='0' cellpadding='5'>
451
+
452
+ <tr valign='top'>
453
+ <td class='attr-rw'>
454
+ [R]
455
+ </td>
456
+ <td class='attr-name'>degrees</td>
457
+ <td class='attr-desc'><p>Degrees of the temperature.</p></td>
458
+ </tr>
459
+
460
+ <tr valign='top'>
461
+ <td class='attr-rw'>
462
+ [R]
463
+ </td>
464
+ <td class='attr-name'>scale</td>
465
+ <td class='attr-desc'><p>Scale of the temperature. Look at <a href="BasicTemperature.html#SCALES">SCALES</a> for possible values.</p></td>
466
+ </tr>
467
+
468
+ </table>
469
+
470
+
471
+
472
+ <!-- Methods -->
473
+
474
+ <div class="sectiontitle">Class Public methods</div>
475
+
476
+ <div class="method">
477
+ <div class="title method-title" id="method-c-5B-5D">
478
+
479
+ <b>[](degrees:, scale:)<br />[](degrees, scale)</b>
480
+
481
+ <a href="../classes/Temperature.html#method-c-5B-5D" name="method-c-5B-5D" class="permalink">Link</a>
482
+ </div>
483
+
484
+
485
+ <div class="description">
486
+ <p>Creates a new instance of <a href="Temperature.html"><code>Temperature</code></a>. Alias for <code>new</code>.</p>
487
+ </div>
488
+
489
+
490
+
491
+
492
+
493
+
494
+
495
+
496
+ <div class="sourcecode">
497
+
498
+ <p class="source-link">
499
+ Source:
500
+ <a href="javascript:toggleSource('method-c-5B-5D_source')" id="l_method-c-5B-5D_source">show</a>
501
+
502
+ </p>
503
+ <div id="method-c-5B-5D_source" class="dyn-source">
504
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 215</span>
505
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier ruby-title">[]</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">**</span><span class="ruby-identifier">kwargs</span>)
506
+ <span class="ruby-identifier">new</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">**</span><span class="ruby-identifier">kwargs</span>)
507
+ <span class="ruby-keyword">end</span></pre>
508
+ </div>
509
+ </div>
510
+
511
+ </div>
512
+
513
+ <div class="method">
514
+ <div class="title method-title" id="method-c-new">
515
+
516
+ <b>new(degrees:, scale:)<br />new(degrees, scale)</b>
517
+
518
+ <a href="../classes/Temperature.html#method-c-new" name="method-c-new" class="permalink">Link</a>
519
+ </div>
520
+
521
+
522
+ <div class="description">
523
+ <p>Creates a new instance of <a href="Temperature.html"><code>Temperature</code></a>. Is aliased as <code>[]</code>.</p>
524
+ </div>
525
+
526
+
527
+
528
+
529
+
530
+
531
+
532
+
533
+ <div class="sourcecode">
534
+
535
+ <p class="source-link">
536
+ Source:
537
+ <a href="javascript:toggleSource('method-c-new_source')" id="l_method-c-new_source">show</a>
538
+
539
+ </p>
540
+ <div id="method-c-new_source" class="dyn-source">
541
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 226</span>
542
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">initialize</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">positional_arguments</span>, <span class="ruby-operator">**</span><span class="ruby-identifier">keyword_arguments</span>)
543
+ <span class="ruby-identifier">assert_either_positional_arguments_or_keyword_arguments!</span>(<span class="ruby-identifier">positional_arguments</span>, <span class="ruby-identifier">keyword_arguments</span>)
544
+
545
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">keyword_arguments</span>.<span class="ruby-identifier">any?</span>
546
+ <span class="ruby-identifier">initialize_via_keywords_arguments</span>(<span class="ruby-identifier">keyword_arguments</span>)
547
+ <span class="ruby-keyword">else</span> <span class="ruby-comment"># positional_arguments.any?</span>
548
+ <span class="ruby-identifier">initialize_via_positional_arguments</span>(<span class="ruby-identifier">positional_arguments</span>)
549
+ <span class="ruby-keyword">end</span>
550
+ <span class="ruby-keyword">end</span></pre>
551
+ </div>
552
+ </div>
553
+
554
+ </div>
555
+
556
+
557
+
558
+ <div class="sectiontitle">Instance Public methods</div>
559
+
560
+ <div class="method">
561
+ <div class="title method-title" id="method-i-2B">
562
+
563
+ <b>+(temperature)<br />+(numeric)</b>
564
+
565
+ <a href="../classes/Temperature.html#method-i-2B" name="method-i-2B" class="permalink">Link</a>
566
+ </div>
567
+
568
+
569
+ <div class="description">
570
+ <p>Performs addition. Returns a new <a href="Temperature.html"><code>Temperature</code></a>.</p>
571
+
572
+ <pre><code>Temperature[20, :celsius] + Temperature[10, :celsius]
573
+ # =&gt; 30 °C
574
+ </code></pre>
575
+
576
+ <p>If the second temperature has a different scale, the first temperature is automatically converted to that scale before <code>degrees</code> addition.</p>
577
+
578
+ <pre><code>Temperature[283.15, :kelvin] + Temperature[20, :celsius]
579
+ # =&gt; 30 °C
580
+ </code></pre>
581
+
582
+ <p>Returned temperature will have the same scale as the second temperature.</p>
583
+
584
+ <p>It is possible to add numerics.</p>
585
+
586
+ <pre><code>Temperature[20, :celsius] + 10
587
+ # =&gt; 30 °C
588
+ </code></pre>
589
+
590
+ <p>In such cases, returned temperature will have the same scale as the first temperature.</p>
591
+
592
+ <p>Also <a href="https://ruby-doc.org/core/Numeric.html#method-i-coerce">Ruby coersion mechanism</a> is supported.</p>
593
+
594
+ <pre><code>10 + Temperature[20, :celsius]
595
+ # =&gt; 30 °C
596
+ </code></pre>
597
+ </div>
598
+
599
+
600
+
601
+
602
+
603
+
604
+
605
+
606
+ <div class="sourcecode">
607
+
608
+ <p class="source-link">
609
+ Source:
610
+ <a href="javascript:toggleSource('method-i-2B_source')" id="l_method-i-2B_source">show</a>
611
+
612
+ </p>
613
+ <div id="method-i-2B_source" class="dyn-source">
614
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 493</span>
615
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">+</span>(<span class="ruby-identifier">other</span>)
616
+ <span class="ruby-identifier">assert_numeric_or_temperature!</span>(<span class="ruby-identifier">other</span>)
617
+
618
+ <span class="ruby-identifier">degrees</span>, <span class="ruby-identifier">scale</span> =
619
+ <span class="ruby-keyword">case</span> <span class="ruby-identifier">other</span>
620
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">Numeric</span>
621
+ [<span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">other</span>, <span class="ruby-keyword">self</span>.<span class="ruby-identifier">scale</span>]
622
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">BasicTemperature</span>
623
+ [<span class="ruby-keyword">self</span>.<span class="ruby-identifier">to_scale</span>(<span class="ruby-identifier">other</span>.<span class="ruby-identifier">scale</span>).<span class="ruby-identifier">degrees</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">other</span>.<span class="ruby-identifier">degrees</span>, <span class="ruby-identifier">other</span>.<span class="ruby-identifier">scale</span>]
624
+ <span class="ruby-keyword">end</span>
625
+
626
+ <span class="ruby-constant">BasicTemperature</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">degrees</span>, <span class="ruby-identifier">scale</span>)
627
+ <span class="ruby-keyword">end</span></pre>
628
+ </div>
629
+ </div>
630
+
631
+ </div>
632
+
633
+ <div class="method">
634
+ <div class="title method-title" id="method-i-2D">
635
+
636
+ <b>-(temperature)<br />-(numeric)</b>
637
+
638
+ <a href="../classes/Temperature.html#method-i-2D" name="method-i-2D" class="permalink">Link</a>
639
+ </div>
640
+
641
+
642
+ <div class="description">
643
+ <p>Performs subtraction. Returns a new <a href="Temperature.html"><code>Temperature</code></a>.</p>
644
+
645
+ <pre><code>Temperature[20, :celsius] - Temperature[10, :celsius]
646
+ # =&gt; 10 °C
647
+ </code></pre>
648
+
649
+ <p>If the second temperature has a different scale, the first temperature is automatically converted to that scale before <code>degrees</code> subtraction.</p>
650
+
651
+ <pre><code>Temperature[283.15, :kelvin] + Temperature[10, :celsius]
652
+ # =&gt; 10 °C
653
+ </code></pre>
654
+
655
+ <p>Returned temperature will have the same scale as the second temperature.</p>
656
+
657
+ <p>It is possible to subtract numerics.</p>
658
+
659
+ <pre><code>Temperature[20, :celsius] - 10
660
+ # =&gt; 10 °C
661
+ </code></pre>
662
+
663
+ <p>In such cases, returned temperature will have the same scale as the first temperature.</p>
664
+
665
+ <p>Also <a href="https://ruby-doc.org/core/Numeric.html#method-i-coerce">Ruby coersion mechanism</a> is supported.</p>
666
+
667
+ <pre><code>10 - Temperature[20, :celsius]
668
+ # =&gt; -10 °C
669
+ </code></pre>
670
+ </div>
671
+
672
+
673
+
674
+
675
+
676
+
677
+
678
+
679
+ <div class="sourcecode">
680
+
681
+ <p class="source-link">
682
+ Source:
683
+ <a href="javascript:toggleSource('method-i-2D_source')" id="l_method-i-2D_source">show</a>
684
+
685
+ </p>
686
+ <div id="method-i-2D_source" class="dyn-source">
687
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 537</span>
688
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">-</span>(<span class="ruby-identifier">other</span>)
689
+ <span class="ruby-keyword">self</span> <span class="ruby-operator">+</span> <span class="ruby-operator">-</span><span class="ruby-identifier">other</span>
690
+ <span class="ruby-keyword">end</span></pre>
691
+ </div>
692
+ </div>
693
+
694
+ </div>
695
+
696
+ <div class="method">
697
+ <div class="title method-title" id="method-i-2D-40">
698
+
699
+ <b>-@</b>()
700
+
701
+ <a href="../classes/Temperature.html#method-i-2D-40" name="method-i-2D-40" class="permalink">Link</a>
702
+ </div>
703
+
704
+
705
+ <div class="description">
706
+ <p>Returns a new <a href="Temperature.html"><code>Temperature</code></a> with negated <code>degrees</code>.</p>
707
+
708
+ <pre><code>-Temperature[20, :celsius]
709
+ # =&gt; -20 °C
710
+ </code></pre>
711
+ </div>
712
+
713
+
714
+
715
+
716
+
717
+
718
+
719
+
720
+ <div class="sourcecode">
721
+
722
+ <p class="source-link">
723
+ Source:
724
+ <a href="javascript:toggleSource('method-i-2D-40_source')" id="l_method-i-2D-40_source">show</a>
725
+
726
+ </p>
727
+ <div id="method-i-2D-40_source" class="dyn-source">
728
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 547</span>
729
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">-@</span>
730
+ <span class="ruby-constant">BasicTemperature</span>.<span class="ruby-identifier">new</span>(<span class="ruby-operator">-</span><span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span>, <span class="ruby-keyword">self</span>.<span class="ruby-identifier">scale</span>)
731
+ <span class="ruby-keyword">end</span></pre>
732
+ </div>
733
+ </div>
734
+
735
+ </div>
736
+
737
+ <div class="method">
738
+ <div class="title method-title" id="method-i-3C-3D-3E">
739
+
740
+ <b>&lt;=&gt;</b>(other)
741
+
742
+ <a href="../classes/Temperature.html#method-i-3C-3D-3E" name="method-i-3C-3D-3E" class="permalink">Link</a>
743
+ </div>
744
+
745
+
746
+ <div class="description">
747
+ <p>Compares temperture with <code>other</code> temperature.</p>
748
+
749
+ <p>Returns <code>0</code> if they are considered as equal.</p>
750
+
751
+ <p>Two temperatures are considered as equal when they have the same amount of <code>degrees</code>.</p>
752
+
753
+ <p>Returns <code>-1</code> if temperature is lower than <code>other</code> temperature.</p>
754
+
755
+ <p>Returns <code>1</code> if temperature is higher than <code>other</code> temperature.</p>
756
+
757
+ <p>If <code>other</code> temperature has a different scale, temperature is automatically converted to that scale before <code>degrees</code> comparison.</p>
758
+
759
+ <pre><code>Temperature[20, :celsius] &lt;=&gt; Temperature[20, :celsius]
760
+ # =&gt; 0
761
+
762
+ Temperature[20, :celsius] &lt;=&gt; Temperature[293.15, :kelvin]
763
+ # =&gt; 0
764
+ </code></pre>
765
+
766
+ <p>IMPORTANT!!!</p>
767
+
768
+ <p>This method rounds <code>degrees</code> to the nearest value with a precision of 2 decimal digits.</p>
769
+
770
+ <p>This means the following:</p>
771
+
772
+ <pre><code>Temperature[20.020, :celsius] &lt;=&gt; Temperature[20.024, :celsius]
773
+ # =&gt; 0
774
+
775
+ Temperature[20.025, :celsius] &lt;=&gt; Temperature[20.029, :celsius]
776
+ # =&gt; 0
777
+
778
+ Temperature[20.024, :celsius] &lt;=&gt; Temperature[20.029, :celsius]
779
+ # =&gt; -1
780
+ </code></pre>
781
+ </div>
782
+
783
+
784
+
785
+
786
+
787
+
788
+
789
+
790
+ <div class="sourcecode">
791
+
792
+ <p class="source-link">
793
+ Source:
794
+ <a href="javascript:toggleSource('method-i-3C-3D-3E_source')" id="l_method-i-3C-3D-3E_source">show</a>
795
+
796
+ </p>
797
+ <div id="method-i-3C-3D-3E_source" class="dyn-source">
798
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 457</span>
799
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">&lt;=&gt;</span>(<span class="ruby-identifier">other</span>)
800
+ <span class="ruby-keyword">return</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">assert_temperature</span>(<span class="ruby-identifier">other</span>)
801
+
802
+ <span class="ruby-identifier">compare_degrees</span>(<span class="ruby-keyword">self</span>.<span class="ruby-identifier">to_scale</span>(<span class="ruby-identifier">other</span>.<span class="ruby-identifier">scale</span>).<span class="ruby-identifier">degrees</span>, <span class="ruby-identifier">other</span>.<span class="ruby-identifier">degrees</span>)
803
+ <span class="ruby-keyword">end</span></pre>
804
+ </div>
805
+ </div>
806
+
807
+ </div>
808
+
809
+ <div class="method">
810
+ <div class="title method-title" id="method-i-set_degrees">
811
+
812
+ <b>set_degrees</b>(degrees)
813
+
814
+ <a href="../classes/Temperature.html#method-i-set_degrees" name="method-i-set_degrees" class="permalink">Link</a>
815
+ </div>
816
+
817
+
818
+ <div class="description">
819
+ <p>Returns a new <a href="Temperature.html"><code>Temperature</code></a> with updated <code>degrees</code>.</p>
820
+
821
+ <pre><code>temperature = Temperature[0, :celsius]
822
+ # =&gt; 0 °C
823
+
824
+ new_temperature = temperature.set_degrees(15)
825
+ # =&gt; 15 °C
826
+ </code></pre>
827
+ </div>
828
+
829
+
830
+
831
+
832
+
833
+
834
+
835
+
836
+ <div class="sourcecode">
837
+
838
+ <p class="source-link">
839
+ Source:
840
+ <a href="javascript:toggleSource('method-i-set_degrees_source')" id="l_method-i-set_degrees_source">show</a>
841
+
842
+ </p>
843
+ <div id="method-i-set_degrees_source" class="dyn-source">
844
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 246</span>
845
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_degrees</span>(<span class="ruby-identifier">degrees</span>)
846
+ <span class="ruby-constant">BasicTemperature</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">degrees</span>, <span class="ruby-identifier">scale</span>)
847
+ <span class="ruby-keyword">end</span></pre>
848
+ </div>
849
+ </div>
850
+
851
+ </div>
852
+
853
+ <div class="method">
854
+ <div class="title method-title" id="method-i-set_scale">
855
+
856
+ <b>set_scale</b>(scale)
857
+
858
+ <a href="../classes/Temperature.html#method-i-set_scale" name="method-i-set_scale" class="permalink">Link</a>
859
+ </div>
860
+
861
+
862
+ <div class="description">
863
+ <p>Returns a new <a href="Temperature.html"><code>Temperature</code></a> with updated <code>scale</code>.</p>
864
+
865
+ <pre><code>temperature = Temperature[0, :celsius]
866
+ # =&gt; 0 °C
867
+
868
+ new_temperature = temperature.set_scale(:kelvin)
869
+ # =&gt; 0 K
870
+ </code></pre>
871
+ </div>
872
+
873
+
874
+
875
+
876
+
877
+
878
+
879
+
880
+ <div class="sourcecode">
881
+
882
+ <p class="source-link">
883
+ Source:
884
+ <a href="javascript:toggleSource('method-i-set_scale_source')" id="l_method-i-set_scale_source">show</a>
885
+
886
+ </p>
887
+ <div id="method-i-set_scale_source" class="dyn-source">
888
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 261</span>
889
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_scale</span>(<span class="ruby-identifier">scale</span>)
890
+ <span class="ruby-constant">BasicTemperature</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">degrees</span>, <span class="ruby-identifier">scale</span>)
891
+ <span class="ruby-keyword">end</span></pre>
892
+ </div>
893
+ </div>
894
+
895
+ </div>
896
+
897
+ <div class="method">
898
+ <div class="title method-title" id="method-i-to_celsius">
899
+
900
+ <b>to_celsius</b>()
901
+
902
+ <a href="../classes/Temperature.html#method-i-to_celsius" name="method-i-to_celsius" class="permalink">Link</a>
903
+ </div>
904
+
905
+
906
+ <div class="description">
907
+ <p>Converts temperature to Celsius scale. If temperature is already in Celsius, returns current temperature object.</p>
908
+
909
+ <p>Memoizes subsequent calls.</p>
910
+
911
+ <p>Conversion formulas are taken from <a href="https://www.rapidtables.com/">RapidTables</a>:</p>
912
+ <ol><li>
913
+ <p><a href="https://www.rapidtables.com/convert/temperature/celsius-to-fahrenheit.html">Celsius to Fahrenheit</a>.</p>
914
+ </li><li>
915
+ <p><a href="https://www.rapidtables.com/convert/temperature/celsius-to-kelvin.html">Celsius to Kelvin</a>.</p>
916
+ </li><li>
917
+ <p><a href="https://www.rapidtables.com/convert/temperature/celsius-to-rankine.html">Celsius to Rankine</a>.</p>
918
+ </li></ol>
919
+
920
+ <pre><code>Temperature[0, :fahrenheit].to_celsius
921
+ # =&gt; -17.78 °C
922
+ </code></pre>
923
+ </div>
924
+
925
+
926
+
927
+
928
+
929
+
930
+
931
+
932
+ <div class="sourcecode">
933
+
934
+ <p class="source-link">
935
+ Source:
936
+ <a href="javascript:toggleSource('method-i-to_celsius_source')" id="l_method-i-to_celsius_source">show</a>
937
+
938
+ </p>
939
+ <div id="method-i-to_celsius_source" class="dyn-source">
940
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 308</span>
941
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">to_celsius</span>
942
+ <span class="ruby-identifier">memoized</span>(<span class="ruby-value">:to_celsius</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">memoize</span>(<span class="ruby-value">:to_celsius</span>, <span class="ruby-operator">-&gt;</span> {
943
+ <span class="ruby-keyword">return</span> <span class="ruby-keyword">self</span> <span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">scale</span> <span class="ruby-operator">==</span> <span class="ruby-constant">CELSIUS</span>
944
+
945
+ <span class="ruby-identifier">degrees</span> =
946
+ <span class="ruby-keyword">case</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">scale</span>
947
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">FAHRENHEIT</span>
948
+ (<span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">-</span> <span class="ruby-value">32</span>) <span class="ruby-operator">*</span> (<span class="ruby-value">5</span> <span class="ruby-operator">/</span> <span class="ruby-value">9r</span>)
949
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">KELVIN</span>
950
+ <span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">-</span> <span class="ruby-value">273.15</span>
951
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">RANKINE</span>
952
+ (<span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">-</span> <span class="ruby-value">491.67</span>) <span class="ruby-operator">*</span> (<span class="ruby-value">5</span> <span class="ruby-operator">/</span> <span class="ruby-value">9r</span>)
953
+ <span class="ruby-keyword">end</span>
954
+
955
+ <span class="ruby-constant">BasicTemperature</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">degrees</span>, <span class="ruby-constant">CELSIUS</span>)
956
+ })
957
+ <span class="ruby-keyword">end</span></pre>
958
+ </div>
959
+ </div>
960
+
961
+ </div>
962
+
963
+ <div class="method">
964
+ <div class="title method-title" id="method-i-to_fahrenheit">
965
+
966
+ <b>to_fahrenheit</b>()
967
+
968
+ <a href="../classes/Temperature.html#method-i-to_fahrenheit" name="method-i-to_fahrenheit" class="permalink">Link</a>
969
+ </div>
970
+
971
+
972
+ <div class="description">
973
+ <p>Converts temperature to Fahrenheit scale. If temperature is already in Fahrenheit, returns current temperature object.</p>
974
+
975
+ <p>Memoizes subsequent calls.</p>
976
+
977
+ <p>Conversion formulas are taken from <a href="https://www.rapidtables.com/">RapidTables</a>:</p>
978
+ <ol><li>
979
+ <p><a href="https://www.rapidtables.com/convert/temperature/fahrenheit-to-celsius.html">Fahrenheit to Celsius</a>.</p>
980
+ </li><li>
981
+ <p><a href="https://www.rapidtables.com/convert/temperature/fahrenheit-to-kelvin.html">Fahrenheit to Kelvin</a>.</p>
982
+ </li><li>
983
+ <p><a href="https://www.rapidtables.com/convert/temperature/fahrenheit-to-rankine.html">Fahrenheit to Rankine</a>.</p>
984
+ </li></ol>
985
+
986
+ <pre><code>Temperature[0, :celsius].to_fahrenheit
987
+ # =&gt; 32 °F
988
+ </code></pre>
989
+ </div>
990
+
991
+
992
+
993
+
994
+
995
+
996
+
997
+
998
+ <div class="sourcecode">
999
+
1000
+ <p class="source-link">
1001
+ Source:
1002
+ <a href="javascript:toggleSource('method-i-to_fahrenheit_source')" id="l_method-i-to_fahrenheit_source">show</a>
1003
+
1004
+ </p>
1005
+ <div id="method-i-to_fahrenheit_source" class="dyn-source">
1006
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 340</span>
1007
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">to_fahrenheit</span>
1008
+ <span class="ruby-identifier">memoized</span>(<span class="ruby-value">:to_fahrenheit</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">memoize</span>(<span class="ruby-value">:to_fahrenheit</span>, <span class="ruby-operator">-&gt;</span> {
1009
+ <span class="ruby-keyword">return</span> <span class="ruby-keyword">self</span> <span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">scale</span> <span class="ruby-operator">==</span> <span class="ruby-constant">FAHRENHEIT</span>
1010
+
1011
+ <span class="ruby-identifier">degrees</span> =
1012
+ <span class="ruby-keyword">case</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">scale</span>
1013
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">CELSIUS</span>
1014
+ <span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">*</span> (<span class="ruby-value">9</span> <span class="ruby-operator">/</span> <span class="ruby-value">5r</span>) <span class="ruby-operator">+</span> <span class="ruby-value">32</span>
1015
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">KELVIN</span>
1016
+ <span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">*</span> (<span class="ruby-value">9</span> <span class="ruby-operator">/</span> <span class="ruby-value">5r</span>) <span class="ruby-operator">-</span> <span class="ruby-value">459.67</span>
1017
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">RANKINE</span>
1018
+ <span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">-</span> <span class="ruby-value">459.67</span>
1019
+ <span class="ruby-keyword">end</span>
1020
+
1021
+ <span class="ruby-constant">BasicTemperature</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">degrees</span>, <span class="ruby-constant">FAHRENHEIT</span>)
1022
+ })
1023
+ <span class="ruby-keyword">end</span></pre>
1024
+ </div>
1025
+ </div>
1026
+
1027
+ </div>
1028
+
1029
+ <div class="method">
1030
+ <div class="title method-title" id="method-i-to_kelvin">
1031
+
1032
+ <b>to_kelvin</b>()
1033
+
1034
+ <a href="../classes/Temperature.html#method-i-to_kelvin" name="method-i-to_kelvin" class="permalink">Link</a>
1035
+ </div>
1036
+
1037
+
1038
+ <div class="description">
1039
+ <p>Converts temperature to Kelvin scale. If temperature is already in Kelvin, returns current</p>
1040
+
1041
+ <pre><code>temperature object.
1042
+ </code></pre>
1043
+
1044
+ <p>Memoizes subsequent calls.</p>
1045
+
1046
+ <p>Conversion formulas are taken from <a href="https://www.rapidtables.com/">RapidTables</a>:</p>
1047
+ <ol><li>
1048
+ <p><a href="https://www.rapidtables.com/convert/temperature/kelvin-to-celsius.html">Kelvin to Celsius</a>.</p>
1049
+ </li><li>
1050
+ <p><a href="https://www.rapidtables.com/convert/temperature/kelvin-to-fahrenheit.html">Kelvin to Fahrenheit</a>.</p>
1051
+ </li><li>
1052
+ <p><a href="https://www.rapidtables.com/convert/temperature/kelvin-to-rankine.html">Kelvin to Rankine</a>.</p>
1053
+ </li></ol>
1054
+
1055
+ <pre><code>Temperature[0, :kelvin].to_rankine
1056
+ # =&gt; 0 °R
1057
+ </code></pre>
1058
+ </div>
1059
+
1060
+
1061
+
1062
+
1063
+
1064
+
1065
+
1066
+
1067
+ <div class="sourcecode">
1068
+
1069
+ <p class="source-link">
1070
+ Source:
1071
+ <a href="javascript:toggleSource('method-i-to_kelvin_source')" id="l_method-i-to_kelvin_source">show</a>
1072
+
1073
+ </p>
1074
+ <div id="method-i-to_kelvin_source" class="dyn-source">
1075
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 372</span>
1076
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">to_kelvin</span>
1077
+ <span class="ruby-identifier">memoized</span>(<span class="ruby-value">:to_kelvin</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">memoize</span>(<span class="ruby-value">:to_kelvin</span>, <span class="ruby-operator">-&gt;</span> {
1078
+ <span class="ruby-keyword">return</span> <span class="ruby-keyword">self</span> <span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">scale</span> <span class="ruby-operator">==</span> <span class="ruby-constant">KELVIN</span>
1079
+
1080
+ <span class="ruby-identifier">degrees</span> =
1081
+ <span class="ruby-keyword">case</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">scale</span>
1082
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">CELSIUS</span>
1083
+ <span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">+</span> <span class="ruby-value">273.15</span>
1084
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">FAHRENHEIT</span>
1085
+ (<span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">+</span> <span class="ruby-value">459.67</span>) <span class="ruby-operator">*</span> (<span class="ruby-value">5</span> <span class="ruby-operator">/</span> <span class="ruby-value">9r</span>)
1086
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">RANKINE</span>
1087
+ <span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">*</span> (<span class="ruby-value">5</span> <span class="ruby-operator">/</span> <span class="ruby-value">9r</span>)
1088
+ <span class="ruby-keyword">end</span>
1089
+
1090
+ <span class="ruby-constant">BasicTemperature</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">degrees</span>, <span class="ruby-constant">KELVIN</span>)
1091
+ })
1092
+ <span class="ruby-keyword">end</span></pre>
1093
+ </div>
1094
+ </div>
1095
+
1096
+ </div>
1097
+
1098
+ <div class="method">
1099
+ <div class="title method-title" id="method-i-to_rankine">
1100
+
1101
+ <b>to_rankine</b>()
1102
+
1103
+ <a href="../classes/Temperature.html#method-i-to_rankine" name="method-i-to_rankine" class="permalink">Link</a>
1104
+ </div>
1105
+
1106
+
1107
+ <div class="description">
1108
+ <p>Converts temperature to Rankine scale. If temperature is already in Rankine, returns current temperature object.</p>
1109
+
1110
+ <p>Memoizes subsequent calls.</p>
1111
+
1112
+ <p>Conversion formulas are taken from <a href="https://www.rapidtables.com/">RapidTables</a>:</p>
1113
+ <ol><li>
1114
+ <p><a href="https://www.rapidtables.com/convert/temperature/rankine-to-celsius.html">Rankine to Celsius</a>.</p>
1115
+ </li><li>
1116
+ <p><a href="https://www.rapidtables.com/convert/temperature/rankine-to-fahrenheit.html">Rankine to Fahrenheit</a>.</p>
1117
+ </li><li>
1118
+ <p><a href="https://www.rapidtables.com/convert/temperature/rankine-to-kelvin.html">Rankine to Kelvin</a>.</p>
1119
+ </li></ol>
1120
+
1121
+ <pre><code>Temperature[0, :rankine].to_kelvin
1122
+ # =&gt; 0 K
1123
+ </code></pre>
1124
+ </div>
1125
+
1126
+
1127
+
1128
+
1129
+
1130
+
1131
+
1132
+
1133
+ <div class="sourcecode">
1134
+
1135
+ <p class="source-link">
1136
+ Source:
1137
+ <a href="javascript:toggleSource('method-i-to_rankine_source')" id="l_method-i-to_rankine_source">show</a>
1138
+
1139
+ </p>
1140
+ <div id="method-i-to_rankine_source" class="dyn-source">
1141
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 404</span>
1142
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">to_rankine</span>
1143
+ <span class="ruby-identifier">memoized</span>(<span class="ruby-value">:to_rankine</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">memoize</span>(<span class="ruby-value">:to_rankine</span>, <span class="ruby-operator">-&gt;</span> {
1144
+ <span class="ruby-keyword">return</span> <span class="ruby-keyword">self</span> <span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">scale</span> <span class="ruby-operator">==</span> <span class="ruby-constant">RANKINE</span>
1145
+
1146
+ <span class="ruby-identifier">degrees</span> =
1147
+ <span class="ruby-keyword">case</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">scale</span>
1148
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">CELSIUS</span>
1149
+ (<span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">+</span> <span class="ruby-value">273.15</span>) <span class="ruby-operator">*</span> (<span class="ruby-value">9</span> <span class="ruby-operator">/</span> <span class="ruby-value">5r</span>)
1150
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">FAHRENHEIT</span>
1151
+ <span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">+</span> <span class="ruby-value">459.67</span>
1152
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">KELVIN</span>
1153
+ <span class="ruby-keyword">self</span>.<span class="ruby-identifier">degrees</span> <span class="ruby-operator">*</span> (<span class="ruby-value">9</span> <span class="ruby-operator">/</span> <span class="ruby-value">5r</span>)
1154
+ <span class="ruby-keyword">end</span>
1155
+
1156
+ <span class="ruby-constant">BasicTemperature</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">degrees</span>, <span class="ruby-constant">RANKINE</span>)
1157
+ })
1158
+ <span class="ruby-keyword">end</span></pre>
1159
+ </div>
1160
+ </div>
1161
+
1162
+ </div>
1163
+
1164
+ <div class="method">
1165
+ <div class="title method-title" id="method-i-to_scale">
1166
+
1167
+ <b>to_scale</b>(scale)
1168
+
1169
+ <a href="../classes/Temperature.html#method-i-to_scale" name="method-i-to_scale" class="permalink">Link</a>
1170
+ </div>
1171
+
1172
+
1173
+ <div class="description">
1174
+ <p>Converts temperature to specific <code>scale</code>. If temperature is already in desired <code>scale</code>, returns current temperature object.</p>
1175
+
1176
+ <p>Raises <a href="BasicTemperature/InvalidScaleError.html">InvalidScaleError</a> when <code>scale</code> can not be casted to any possible scale value (see <a href="BasicTemperature.html#SCALES">SCALES</a>).</p>
1177
+
1178
+ <pre><code>Temperature[60, :fahrenheit].to_scale(:celsius)
1179
+ # =&gt; 15.56 °C
1180
+ </code></pre>
1181
+ </div>
1182
+
1183
+
1184
+
1185
+
1186
+
1187
+
1188
+
1189
+
1190
+ <div class="sourcecode">
1191
+
1192
+ <p class="source-link">
1193
+ Source:
1194
+ <a href="javascript:toggleSource('method-i-to_scale_source')" id="l_method-i-to_scale_source">show</a>
1195
+
1196
+ </p>
1197
+ <div id="method-i-to_scale_source" class="dyn-source">
1198
+ <pre><span class="ruby-comment"># File lib/basic_temperature.rb, line 277</span>
1199
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">to_scale</span>(<span class="ruby-identifier">scale</span>)
1200
+ <span class="ruby-identifier">casted_scale</span> = <span class="ruby-identifier">cast_scale</span>(<span class="ruby-identifier">scale</span>)
1201
+
1202
+ <span class="ruby-identifier">assert_valid_scale!</span>(<span class="ruby-identifier">casted_scale</span>)
1203
+
1204
+ <span class="ruby-keyword">case</span> <span class="ruby-identifier">casted_scale</span>
1205
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">CELSIUS</span>
1206
+ <span class="ruby-identifier">to_celsius</span>
1207
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">FAHRENHEIT</span>
1208
+ <span class="ruby-identifier">to_fahrenheit</span>
1209
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">KELVIN</span>
1210
+ <span class="ruby-identifier">to_kelvin</span>
1211
+ <span class="ruby-keyword">when</span> <span class="ruby-constant">RANKINE</span>
1212
+ <span class="ruby-identifier">to_rankine</span>
1213
+ <span class="ruby-keyword">end</span>
1214
+ <span class="ruby-keyword">end</span></pre>
1215
+ </div>
1216
+ </div>
1217
+
1218
+ </div>
1219
+
1220
+
1221
+
1222
+
1223
+ </div>
1224
+
1225
+ </div>
1226
+ </body>
1227
+ </html>