In Ruby, how does coerce() actually work?

by

Short answer: check out how Matrix is doing it.

The idea is that coerce returns [equivalent_something, equivalent_self], where equivalent_something is an object basically equivalent to something but that knows how to do operations on your Point class. In the Matrix lib, we construct a Matrix::Scalar from any Numeric object, and that class knows how to perform operations on Matrix and Vector.

To address your points:

  1. Yes, it is Ruby directly (check calls to rb_num_coerce_bin in the source), although your own types should do too if you want your code to be extensible by others. For example if your Point#* is passed an argument it doesn’t recognize, you would ask that argument to coerce itself to a Point by calling arg.coerce(self).

  2. Yes, it has to be an Array of 2 elements, such that b_equiv, a_equiv = a.coerce(b)

  3. Yes. Ruby does it for builtin types, and you should too on your own custom types if you want to be extensible:

    def *(arg)
  if (arg is not recognized)
    self_equiv, arg_equiv = arg.coerce(self)
    self_equiv * arg_equiv
  end
end

  4. The idea is that you shouldn’t modify Fixnum#*. If it doesn’t know what to do, for example because the argument is a Point, then it will ask you by calling Point#coerce.

  5. Transitivity (or actually commutativity) is not necessary, because the operator is always called in the right order. It’s only the call to coerce which temporarily reverts the received and the argument. There is no builtin mechanism that insures commutativity of operators like +, ==, etc…

If someone can come up with a terse, precise and clear description to improve the official documentation, leave a comment!

More Related Contents:

  1. What is the difference between require_relative and require in Ruby?
  2. Why does Ruby 1.9.2 remove “.” from LOAD_PATH, and what’s the alternative?
  3. Ruby Gem install Json fails on Mavericks and Xcode 5.1 – unknown argument: ‘-multiply_definedsuppress’
  4. Blocks and yields in Ruby
  5. Best way to require all files from a directory in ruby?
  6. What does %w(array) mean?
  7. How to get argument names using reflection
  8. How to make a HTTP request using Ruby on Rails?
  9. Continuously read from STDOUT of external process in Ruby
  10. How to count duplicate elements in a Ruby array
  11. When to use `self.foo` instead of `foo` in Ruby methods
  12. What is the “=~” operator in Ruby?
  13. Ruby send JSON request
  14. Is the ruby operator ||= intelligent?
  15. Ruby method Array#
  16. What does ||= mean in Ruby? [duplicate]
  17. How to avoid tripping over UTF-8 BOM when reading files
  18. String concatenation in Ruby
  19. How do you uninstall rbenv on macOS?
  20. Ruby: Easiest Way to Filter Hash Keys?
  21. Ruby ‘require’ error: cannot load such file
  22. Testing modules in RSpec
  23. Why do two strings separated by space concatenate in Ruby?
  24. How to assign hash[‘a’][‘b’]= ‘c’ if hash[‘a’] doesn’t exist?
  25. How to create directories recursively in ruby?
  26. Logging in Sinatra?
  27. what does @ stand for in a Ruby function name
  28. How to get class instances in Ruby? [duplicate]
  29. Ruby Definition of Self
  30. How to match something with regex that is not between two special characters?

Leave a Comment