String#delete_suffix

(::string suffix) -> ::String

delete_suffix(suffix) → new_string

static VALUE
rb_str_delete_suffix(VALUE str, VALUE suffix)
{
    long suffixlen;

    suffixlen = deleted_suffix_length(str, suffix);
    if (suffixlen <= 0) return str_duplicate(rb_cString, str);

    return rb_str_subseq(str, 0, RSTRING_LEN(str) - suffixlen);
}

Returns a copy of self with trailing substring suffix removed:

Example

'hello'.delete_suffix('llo')      # => "he"
'hello'.delete_suffix('hel')      # => "hello"
'тест'.delete_suffix('ст')        # => "те"
'こんにちは'.delete_suffix('ちは')  # => "こんに"

Ruby version changes

3.0
- The following methods now return or yield String instances instead of subclass instances when called on subclass instances: [Bug #10845]

See also #delete_suffix! #delete_prefix! #delete_prefix #downcase also in 4.1 · 4.0 · 3.3 · 3.2 · 3.1 · 3.0

‹ prev#delete_prefix! next ›#delete_suffix!