123456789_123456789_123456789_123456789_123456789_

Module: Matrix::CoercionHelper

Do not use. This module is for internal use only.
Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In:
::Matrix, Scalar, ::Vector
Defined in: lib/matrix.rb

Class Method Summary

Instance Method Summary

Class Method Details

.check_int(val, count, kind)

[ GitHub ] 

  


# File 'lib/matrix.rb', line 1791



def self.check_int(val, count, kind)
  val = CoercionHelper.coerce_to_int(val)
  if val >= count || val < -count
    raise IndexError, "given #{kind} #{val} is outside of #{-count}...#{count}"
  end
  val
end


  








  

    .check_range(val, count, kind)  
  



  

    

Returns nil for non Ranges Checks range validity, return canonical range with 0 <= begin <= end < count


  



  [ GitHub ]


  

  


# File 'lib/matrix.rb', line 1781



def self.check_range(val, count, kind)
  canonical = (val.begin + (val.begin < 0 ? count : 0))..
              (val.end ? val.end + (val.end < 0 ? count : 0) - (val.exclude_end? ? 1 : 0)
                       : count - 1)
  unless 0 <= canonical.begin && canonical.begin <= canonical.end && canonical.end < count
    raise IndexError, "given range #{val} is outside of #{kind} dimensions: 0...#{count}"
  end
  canonical
end


  








  

    .coerce_to(obj, cls, meth)  
  



  

    

Helper method to coerce a value into a specific class. Raises a TypeError if the coercion fails or the returned value is not of the right class. (from Rubinius)


  





  
Raises:


    
  
  • 
    (TypeError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/matrix.rb', line 1758



def self.coerce_to(obj, cls, meth) # :nodoc:
  return obj if obj.kind_of?(cls)
  raise TypeError, "Expected a #{cls} but got a #{obj.class}" unless obj.respond_to? meth
  begin
    ret = obj.__send__(meth)
  rescue Exception => e
    raise TypeError, "Coercion error: #{obj.inspect}.#{meth} => #{cls} failed:\n" \
                     "(#{e.message})"
  end
  raise TypeError, "Coercion error: obj.#{meth} did NOT return a #{cls} (was #{ret.class})" unless ret.kind_of? cls
  ret
end


  








  

    .coerce_to_int(obj)  
  

  [ GitHub ]


  

  


# File 'lib/matrix.rb', line 1771



def self.coerce_to_int(obj)
  coerce_to(obj, Integer, :to_int)
end


  








  

    .coerce_to_matrix(obj)  
  

  [ GitHub ]


  

  


# File 'lib/matrix.rb', line 1775



def self.coerce_to_matrix(obj)
  coerce_to(obj, Matrix, :to_matrix)
end


  







Instance Method Details



  

    #apply_through_coercion(obj, oper)   (private)
  



  

    

Applies the operator oper with argument obj through coercion of obj


  



  [ GitHub ]


  

  


# File 'lib/matrix.rb', line 1744



private def apply_through_coercion(obj, oper)
  coercion = obj.coerce(self)
  raise TypeError unless coercion.is_a?(Array) && coercion.length == 2
  coercion[0].public_send(oper, coercion[1])
rescue
  raise TypeError, "#{obj.inspect} can't be coerced into #{self.class}"
end