hex_values 0.0.2 → 0.0.3

data/README.md

@@ -25,21 +25,38 @@ Or install it yourself as:
 
 require the gem:
 
-     require 'hex_values'
-
+```ruby
+require 'hex_values'
+```
 And then transform any float to a hexadecimal:
 
-     irb> 234.25.to_hex
-     => "EA.4"
+```ruby
+234.25.to_hex
+# => "EA.4"
+```
 
 Or transform any hexadecimal to the corresponding float:
 
-     irb> "EA.4".to_float
-     => 234.25
+```ruby
+"EA.4".to_float
+# => 234.25
+```
+
+### From float to Hex
+
+The "to_hex" method allows a precision parameter to set the maximum number of decimals to calculate (default 14).
 
+Bear in mind that the larger the number, the larger the amount of time used to get the number:
+
+```ruby
+1875.37.to_hex(50)
+# => 753.5EB851EB851EB851EB851EB851EB851EB851EB851EB851EB85
+```
 
 ## Contributing
 
+There are many, many ways to contribute to this project...but I will only explain two :smile:
+
 ### Forking the project
 
 1. Fork it

data/lib/hex_values/version.rb

@@ -1,3 +1,3 @@
 module HexValues
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/lib/hex_values.rb

@@ -3,12 +3,14 @@ require "hex_values/version"
 module HexValuesFromFloat
   MAX_DECIMALS = 14
 
-  def to_hex
+  def to_hex(precision = MAX_DECIMALS)
+    precision = MAX_DECIMALS if precision < 0
+
     num,dec = get_hex_value(self)
     first = num
     second = ""
     iterations = 0
-    while dec > 0 && iterations < MAX_DECIMALS
+    while dec > 0 && iterations < precision
       num, dec = get_hex_value(dec*16)
       second << num
       iterations += 1
@@ -58,7 +60,7 @@ class String
 end
 
 class Fixnum
-  def to_hex
-    self.to_f.to_hex
+  def to_hex(precision=HexValuesFromFloat::MAX_DECIMALS)
+    self.to_f.to_hex(precision)
   end
 end

data/spec/hex_values_spec.rb

@@ -39,6 +39,64 @@ describe 'HexValues' do
     end
   end
 
+  describe "float to hex with precision" do
+    it "converts 234.25 to EA.4 (no matter precision)" do
+      result = 234.25.to_hex(140)
+      result.must_equal "EA.4"
+      num, dec = result.split('.')
+      dec.size.must_equal 1
+    end
+
+    it "converts 1875.37 with 5 numbers after period" do
+      result = 1875.37.to_hex(5)
+      result.must_equal "753.5EB85"
+      num, dec = result.split('.')
+      dec.size.must_equal 5
+    end
+
+    it "converts 1875.37 with 50 numbers after period" do
+      result = 1875.37.to_hex(50)
+      num, dec = result.split('.')
+      dec.size.must_equal 50
+    end
+
+    it "converts 1875.37 with 0 numbers after period" do
+      result = 1875.37.to_hex(0)
+      result.must_equal "753"
+      num, dec = result.split('.')
+      dec.must_be_nil
+    end
+
+    it "converts 1875.37 with 14 numbers after period (if a negative precision is provided)" do
+      result = 1875.37.to_hex(-1)
+      result.must_equal "753.5EB851EB851EB8"
+      num, dec = result.split('.')
+      dec.size.must_equal 14
+    end
+  end
+
+  describe "integer to hex with precision" do
+    it "converts 1 to 1 (without parameter)" do
+      1.to_hex.must_equal "1"
+    end
+
+    it "converts 1 to 1 (with precision = 40)" do
+      1.to_hex(14).must_equal "1"
+    end
+
+    it "converts 1 to 1 (with precision = 0)" do
+      1.to_hex(0).must_equal "1"
+    end
+
+    it "converts 1 to 1 (with precision = -1)" do
+      1.to_hex(-1).must_equal "1"
+    end
+
+    it "converts 13 to D (with precision = 12)" do
+      13.to_hex(12).must_equal "D"
+    end
+  end
+
   describe "hex to float" do
     it "converts EA.4 to 234.25" do
       "EA.4".to_float.must_equal 234.25

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hex_values
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors: