Preview Ruby 4.1 is a preview. It can change before the final release. Switch to Ruby 4.0 →
class method
String.try_convert
(::String object) -> ::String
(::_ToStr object) -> ::String
(untyped object) -> ::String?
String.try_convert(object) → object, new_string, or nil
string.c
View on GitHub ↗
static VALUE
rb_str_s_try_convert(VALUE dummy, VALUE str)
{
return rb_check_string_type(str);
}
Attempts to convert the given object to a string.
If object is already a string, returns object, unmodified.
Otherwise if object responds to :to_str, calls object.to_str and returns the result.
Returns nil if object does not respond to :to_str.
Raises an exception unless object.to_str returns a string.