missing-math 0.1.1 → 0.1.2

data/lib/missing_math.rb

@@ -1,46 +1,192 @@
 module MissingMath
 
-  def prime?
-    throw "Not an Integer" if !self.is_i?
-    begin
-      last = Math.sqrt(self).floor
-      i = 2
-      while i <= last
+  # Methods that can apply to all number object types
+  module Number
+    # Returns the number of digits in the number (if a float, decimal is excluded)
+    # Example: 12345.length => 5
+    def length
+      str = self.to_s
+      if str.index('.')
+        str.length - 1
+      elsif
+        str.length
+      end
+    end
+
+    # Returns the number with a number added to the beginning of the number
+    # @param integer n The number to prepend
+    # Example: 2345.prepend(1) => 12345
+    def prepend(n)
+      str = "#{n}#{self}"
+      number_out(str)
+    end
+
+    # Returns the number with a number added to the end of the number
+    # @param integer n The number to append
+    # Example: 1234.append(5) => 12345
+    def append(n)
+      str = "#{self}#{n}"
+      number_out(str)
+    end
+
+    # Returns the number with the first digit removed from the beginning of the number
+    # Similar to an Array#shift method
+    # Example: 12345.shift => 2345
+    def shift
+      str = self.to_s[1..-1]
+      number_out(str)
+    end
+
+    # Returns the number with the last digit removed from the end of the number
+    # Similar to an Array#pop method
+    # Example: 12345.pop => 1234
+    def pop
+      str = self.to_s[0..-2]
+      number_out(str)
+    end
+
+    # Returns a digit subset/substring of the current number with a 0-indexed integer or range
+    # @param integer|range search The substring search to return
+    # Similar to a String object's substring methods.
+    # Example 1: 12345.substr(2) => 3
+    # Example 2: 12345.substr(0..2) => 123
+    def substr(search)
+      str = self.to_s[search]
+      number_out(str)
+    end
+
+    # Returns the number with the first digit moved to the end
+    # @param boolean right Defaults to rotating right.  Set to false to rotate left
+    # Example 1: 12345.rotate => 23451
+    # Example 2: 12345.rotate(false) => 51234
+    def rotate(right=true)
+      a = self.to_a
+      if right
+        a.push(a.shift)
+      elsif !right
+        a.unshift(a.pop)
+      end
+      str = a.join('')
+      number_out(str)
+    end
+
+    # Checks if the number contains a digit sequence or regex
+    # @param integer|regexp search
+    # Example 1: 12345.contains?(34) => true
+    # Example 2: 12345.contains?(/34/) => true
+    def contains?(search)
+      if search.is_a? Regexp
+        return self.to_s.scan(search).length > 0 ? true : false
+      else
+        return self.to_s.index(search.to_s) ? true : false
+      end
+    end
+
+    # Converts an number to an array of numbers.  If a decimal number, the decimal will be a position in the array
+    # Example: 12345.to_a => [1, 2, 3, 4, 5]
+    def to_a
+      self.to_s.split('').map do |n|
+        matches = n.scan(/[0-9]/).length
+        if matches > 0
+          n.to_i
+        else
+          n
+        end
+      end
+    end
+
+    private
+
+    # Output a stringed version of a number as a float or integer (whichever it deserves)
+    def number_out(str)
+      i = str.to_i
+      f = str.to_f
+      if i == f
+        return i
+      else
+        return f
+      end
+    end
+  end
+
+
+
+  # Methods that apply to integers
+  module Integer
+    # Returns boolean true|false if integer is prime
+    def prime?
+      throw "Not an Integer" if !self.is_i?
+      begin
+        last = Math.sqrt(self).floor
+        i = 2
+        while i <= last
+          if self % i == 0
+            return false
+          end
+          i += 1
+        end
+        return true
+      rescue
+        false
+      end
+    end
+
+    # Calculates an integer's factorial
+    def factorial
+      throw "Not an Integer" if !self.is_i?
+      self.downto(1).reduce(:*)
+    end
+
+    # Returns an array of an integer's factors
+    # @param boolean include_one To exclude the number 1 from the output, set to false
+    def factors(include_one=true)
+      throw "Not an Integer" if !self.is_i?
+      last = self
+      i = include_one ? 1 : 2
+      a = []
+      while i < last
         if self % i == 0
-          return false
+          last = self / i
+          a << i
+          a << last
         end
         i += 1
       end
-      return true
-    rescue
-      false
+      return a.sort
     end
-  end
 
-  def factorial
-    throw "Not an Integer" if !self.is_i?
-    self.downto(1).reduce(:*)
+    # Returns an array of the integer's prime factors
+    def prime_factors
+      ceil = (self / 2).floor
+      primes = MissingMath.esieve(ceil)
+      factors = primes.collect { |i| self % i == 0 }
+      return factors
+    end
   end
 
-  def factors(include_one=true)
-    throw "Not an Integer" if !self.is_i?
-    last = self
-    i = include_one ? 1 : 2
-    a = []
-    while i < last
-      if self % i == 0
-        last = self / i
-        a << i
-        a << last
-      end
-      i += 1
+
+
+  ### Module methods
+
+  # Generates a prime sieve with max value n
+  # @param integer n Max value of sieve
+  # Example: MissingMath.esieve(1000) => [2, 3, 5, ...]
+  def self.esieve(n)
+    a = (0..n).to_a
+    a[0] = nil
+    a[1] = nil
+    a.each do |i|
+      next unless i
+      break if i * i > n
+      (i * i).step(n, i) { |m| a[m] = nil}
     end
-    return a.sort
+    return a.compact
   end
 
 end
 
 
+
 require 'missing_math/integer'
 require 'missing_math/float'
 require 'missing_math/fixnum'

data/lib/missing_math/fixnum.rb

@@ -1,7 +1,13 @@
 class Fixnum
+  include MissingMath::Number
+
 
   def is_i?
     super
   end
 
+  def is_f?
+    super
+  end
+
 end

data/lib/missing_math/float.rb

@@ -1,7 +1,13 @@
 class Float
+  include MissingMath::Number
+
 
   def is_i?
     false
   end
 
+  def is_f?
+    true
+  end
+
 end

data/lib/missing_math/integer.rb

@@ -1,8 +1,14 @@
 class Integer
-  include MissingMath
+  include MissingMath::Number
+  include MissingMath::Integer
+
 
   def is_i?
     return true
   end
 
+  def is_f?
+    return false
+  end
+
 end

data/lib/missing_math/version.rb

@@ -1,3 +1,3 @@
 module MissingMath
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: missing-math
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-28 00:00:00.000000000 Z
+date: 2013-12-02 00:00:00.000000000 Z
 dependencies: []
 description: A library of missing math functions.
 email: mail@enorganik.com