Merge pull request #75 from vadviktor/vadviktor-patch-range_idea

extended Range#include example with alternatives

Author: JuanitoFatas

README.md

@@ -864,18 +864,24 @@ Comparison:
 
 ```
 $ ruby -v code/range/cover-vs-include.rb
-ruby 2.2.2p95 (2015-04-13 revision 50295) [x86_64-darwin14]
+ruby 2.2.3p173 (2015-08-18 revision 51636) [x86_64-linux]
 
 Calculating -------------------------------------
-        Range#cover?    95.445k i/100ms
-      Range#include?     9.326k i/100ms
+        range#cover?    85.467k i/100ms
+      range#include?     7.720k i/100ms
+       range#member?     7.783k i/100ms
+       plain compare   102.189k i/100ms
 -------------------------------------------------
-        Range#cover?      2.327M (± 4.7%) i/s -     11.644M
-      Range#include?     99.652k (± 5.4%) i/s -    503.604k
+        range#cover?      1.816M (± 5.6%) i/s -      9.060M
+      range#include?     83.344k (± 5.0%) i/s -    416.880k
+       range#member?     82.654k (± 5.0%) i/s -    412.499k
+       plain compare      2.581M (± 6.2%) i/s -     12.876M
 
 Comparison:
-        Range#cover?:  2327220.4 i/s
-      Range#include?:    99651.6 i/s - 23.35x slower
+       plain compare:  2581211.8 i/s
+        range#cover?:  1816038.5 i/s - 1.42x slower
+      range#include?:    83343.9 i/s - 30.97x slower
+       range#member?:    82654.1 i/s - 31.23x slower
 ```
 
 

code/range/cover-vs-include.rb

@@ -5,16 +5,11 @@
 END_OF_JULY = Date.new(2015, 7, 31)
 DAY_IN_JULY = Date.new(2015, 7, 15)
 
-def fast
-  (BEGIN_OF_JULY..END_OF_JULY).cover? DAY_IN_JULY
-end
-
-def slow
-  (BEGIN_OF_JULY..END_OF_JULY).include? DAY_IN_JULY
-end
-
 Benchmark.ips do |x|
-  x.report("Range#cover?") { fast }
-  x.report("Range#include?") { slow }
+  x.report('range#cover?') { (BEGIN_OF_JULY..END_OF_JULY).cover? DAY_IN_JULY }
+  x.report('range#include?') { (BEGIN_OF_JULY..END_OF_JULY).include? DAY_IN_JULY }
+  x.report('range#member?') { (BEGIN_OF_JULY..END_OF_JULY).member? DAY_IN_JULY }
+  x.report('plain compare') { BEGIN_OF_JULY < DAY_IN_JULY && DAY_IN_JULY < END_OF_JULY }
+
   x.compare!
 end