String.try_convert

(::String object) -> ::String

(::_ToStr object) -> ::String

(untyped object) -> ::String?

String.try_convert(object) → object, new_string, or nil

static VALUE
rb_str_s_try_convert(VALUE dummy, VALUE str)
{
    return rb_check_string_type(str);
}

If object is a String object, returns object.

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 object.

See also .new #% #* also in 4.1 · 4.0 · 3.3 · 3.2 · 3.1 · 3.0