Path: | lib/more/facets/typecast.rb |
Last Update: | Mon Jun 01 21:54:17 -0400 2009 |
Provides a generic simple type conversion utility. All the ruby core conversions are available by default.
"1234".cast_to Float => 1234.0 (Float) Time.cast_from("6:30") => 1234.0 (Time)
To implement a new type conversion, you have two choices, take:
class CustomType def initialize(my_var) @my_var = my_var end end
Define a to_class_name instance method
class CustomType def to_string my_var.to_s end end c = CustomType.new 1234 s.cast_to String => "1234" (String)
Define a from_class_name class method
class CustomType def self.from_string(str) self.new(str) end end "1234".cast_to CustomType => #<CustomType:0xb7d1958c @my_var="1234">
Those two methods are equivalent in the result. It was coded like that to avoid the pollution of core classes with tons of to_* methods.
The standard methods to_s, to_f, to_i, to_a and to_sym are also used by this system if available.
a lot of collisions with already existing code. The goal is that each time you call cast_to, you either get your result, either a TypeCastException
Copyright (c) 2004 Jonas Pfenniger Ruby License This module is free software. You may use, modify, and/or redistribute this software under the same terms as Ruby. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.