sixarm_ruby_numeric_round 1.0.0 → 1.0.1

data/README.md

@@ -1,4 +1,4 @@
-# SixArm.com » Ruby » <br> Numeric rounding methods
+# SixArm.com » Ruby » <br> Numeric #round, #floor, #ceil methods with precision
 
 * Doc: <http://sixarm.com/sixarm_ruby_numeric_round/doc>
 * Gem: <http://rubygems.org/gems/sixarm_ruby_numeric_round>
@@ -50,14 +50,16 @@ Round at a given decimal point:
     4.555.ceil_at(1)  #=> 4.6
     4.555.floor_at(1)  #=> 4.5
     4.555.round_at(1)  #=> 4.6
+    4.555.truncate_at(1)  #=> 4.5
 
 Round to a given precision:
 
     4.555.ceil_to(0.1)   #=> 4.6
     4.555.floor_to(0.1)  #=> 4.5
     4.555.round_to(0.1)  #=> 4.6
+    4.555.truncate_to(0.1)  #=> 4.5
 
-Conceptually, the methods for round, floor, and ceil will typically be for floating point numbers.
+Conceptually, the methods for round, floor, ceil, and truncate will typically be for floating point numbers.
 However, these methods can actually be for pretty much any Numeric object.
 For example, one could round an Integer to the nearest kilo.
 
@@ -73,6 +75,7 @@ We're asking the Facets team to consider including the rest of the methods.
 
 ## Changes
 
+* 2012-09-01 1.0.1 Add #truncate_at and #truncate_to.
 * 2012-05-30 1.0.0 Create baesd on Facets methods by Trans.
 
 

data/VERSION

@@ -1 +1 @@
-1.0.0
+1.0.1

data/lib/sixarm_ruby_numeric_round.rb

@@ -53,6 +53,22 @@ class Numeric
     to_f.round_to(*args)
   end
 
+  # Conceptually, truncate is expected to apply to floating point numbers.
+  # However it can actually be applied to pretty much any Numeric object.
+  # For example, one could truncate an Integer to the nearest kilo.
+  #
+  # See Float#truncate_at.
+
+  def truncate_at(*args)
+    to_f.truncate_at(*args)
+  end
+
+  # See Float#truncate_to.
+
+  def truncate_to(*args)
+    to_f.truncate_to(*args)
+  end
+
 end
 
 class Float
@@ -138,4 +154,31 @@ class Float
     (self * (1.0 / n)).round.to_f / (1.0 / n)
   end
 
+  # Truncate to the given decimal position.
+  #
+  #   4.555.truncate_at(0)  #=> 4.0
+  #   4.555.truncate_at(1)  #=> 4.5
+  #   4.555.truncate_at(2)  #=> 4.55
+  #   4.555.truncate_at(3)  #=> 4.555
+  #
+  # CREDIT: Trans & Joel Parker Henderson
+
+  def truncate_at( d ) #d=0
+    (self * (10.0 ** d)).truncate.to_f / (10.0 ** d)
+  end
+
+  # Truncates to the nearest _n_th degree.
+  #
+  #   4.555.truncate_to(1)     #=> 4.0
+  #   4.555.truncate_to(0.1)   #=> 4.5
+  #   4.555.truncate_to(0.01)  #=> 4.55
+  #   4.555.truncate_to(0)     #=> 4.555
+  #
+  # CREDIT: Trans & Joel Parker Henderson
+
+  def truncate_to( n ) #n=1
+    return self if n == 0
+    (self * (1.0 / n)).truncate.to_f / (1.0 / n)
+  end
+
 end

data/test/sixarm_ruby_numeric_round_test.rb

@@ -72,6 +72,28 @@ describe Float do
 
   end
 
+  describe "#truncate_at" do
+
+    it "works" do
+      4.555.truncate_at(0).must_equal 4.0
+      4.555.truncate_at(1).must_equal 4.5
+      4.555.truncate_at(2).must_equal 4.55
+      4.555.truncate_at(3).must_equal 4.555
+    end
+
+  end
+
+  describe "#truncate_to" do
+
+    it "works" do
+      4.555.truncate_to(1).must_equal 4.0
+      4.555.truncate_to(0.1).must_equal 4.5
+      4.555.truncate_to(0.01).must_equal 4.55
+      4.555.truncate_to(0).must_equal 4.555
+    end
+
+  end
+
 end
 
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sixarm_ruby_numeric_round
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -35,7 +35,7 @@ cert_chain:
   L2RORkllUkVIekVSClpEUlFZTXFydTlURU1uYTZIRDl6cGNzdEY3dndUaEdv
   dmxPUSszWTZwbFE0bk16aXBYY1o5VEhxczY1UElMMHEKZWFid3BDYkFvcG89
   Ci0tLS0tRU5EIENFUlRJRklDQVRFLS0tLS0K
-date: 2012-05-31 00:00:00.000000000 Z
+date: 2012-09-02 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: sixarm@sixarm.com
@@ -72,7 +72,7 @@ rubyforge_project:
 rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
-summary: SixArm.com » Ruby » Numeric round, floor, ceil methods
+summary: SixArm.com » Ruby » Numeric round, floor, ceil, truncate methods
 test_files:
 - test/sixarm_ruby_numeric_round_test.rb
 has_rdoc: true

metadata.gz.sig

@@ -1,2 +1 @@
-E����
�nU���'�S1��t$`�W���Ăonp�coxd�HB��+�+i��s</_�w4�C���-k����W��.g����SWR�d|�ºG��`
-M?�Ӽ�N"��a�	X)¤�A��qcO
+cO���2�