Some Ruby methods accept one or more objects that can be either:
Of a given class, and so accepted as is.
Implicitly convertible to that class, in which case the called method converts the object.
For each of the relevant classes, the conversion is done by calling a specific conversion method:
Array: to_ary
Hash: to_hash
Integer: to_int
String: to_str
An Array-convertible object is an object that:
Has instance method to_ary.
The method accepts no arguments.
The method returns an object obj for which obj.kind_of?(Array) returns true.
The Ruby core class that satisfies these requirements is:
The examples in this section use method Array#replace, which accepts an Array-convertible argument.
This class is Array-convertible:
class ArrayConvertible
def to_ary
[:foo, 'bar', 2]
end
end
a = []
a.replace(ArrayConvertible.new)
This class is not Array-convertible (no to_ary method):
class NotArrayConvertible; end a = [] a.replace(NotArrayConvertible.new)
This class is not Array-convertible (method to_ary takes arguments):
class NotArrayConvertible
def to_ary(x)
[:foo, 'bar', 2]
end
end
a = []
a.replace(NotArrayConvertible.new)
This class is not Array-convertible (method to_ary returns non-Array):
class NotArrayConvertible
def to_ary
:foo
end
end
a = []
a.replace(NotArrayConvertible.new)
Hash-Convertible Objects¶ ↑
A Hash-convertible object is an object that:
Has instance method to_hash.
The method accepts no arguments.
The method returns an object obj for which obj.kind_of?(Hash) returns true.
The Ruby core class that satisfies these requirements is:
The examples in this section use method Hash#merge, which accepts a Hash-convertible argument.
This class is Hash-convertible:
class HashConvertible
def to_hash
{foo: 0, bar: 1, baz: 2}
end
end
h = {}
h.merge(HashConvertible.new)
This class is not Hash-convertible (no to_hash method):
class NotHashConvertible; end
h = {}
h.merge(NotHashConvertible.new)
This class is not Hash-convertible (method to_hash takes arguments):
class NotHashConvertible
def to_hash(x)
{foo: 0, bar: 1, baz: 2}
end
end
h = {}
h.merge(NotHashConvertible.new)
This class is not Hash-convertible (method to_hash returns non-Hash):
class NotHashConvertible
def to_hash
:foo
end
end
h = {}
h.merge(NotHashConvertible.new)
Integer-Convertible Objects¶ ↑
An Integer-convertible object is an object that:
Has instance method to_int.
The method accepts no arguments.
The method returns an object obj for which obj.kind_of?(Integer) returns true.
The Ruby core classes that satisfy these requirements are:
The examples in this section use method Array.new, which accepts an Integer-convertible argument.
This user-defined class is Integer-convertible:
class IntegerConvertible
def to_int
3
end
end
a = Array.new(IntegerConvertible.new).size
a
This class is not Integer-convertible (method to_int takes arguments):
class NotIntegerConvertible
def to_int(x)
3
end
end
Array.new(NotIntegerConvertible.new)
This class is not Integer-convertible (method to_int returns non-Integer):
class NotIntegerConvertible
def to_int
:foo
end
end
Array.new(NotIntegerConvertible.new)
String-Convertible Objects¶ ↑
A String-convertible object is an object that:
Has instance method to_str.
The method accepts no arguments.
The method returns an object obj for which obj.kind_of?(String) returns true.
The Ruby core class that satisfies these requirements is:
The examples in this section use method String::new, which accepts a String-convertible argument.
This class is String-convertible:
class StringConvertible
def to_str
'foo'
end
end
String.new(StringConvertible.new)
This class is not String-convertible (no to_str method):
class NotStringConvertible; end String.new(NotStringConvertible.new)
This class is not String-convertible (method to_str takes arguments):
class NotStringConvertible
def to_str(x)
'foo'
end
end
String.new(NotStringConvertible.new)
This class is not String-convertible (method to_str returns non-String):
class NotStringConvertible
def to_str
:foo
end
end
String.new(NotStringConvertible.new)
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4