String#swapcase!

() -> self?

(:ascii | :lithuanian | :turkic) -> self?

(:lithuanian, :turkic) -> self?

(:turkic, :lithuanian) -> self?

swapcase!(*options) → self or nil

static VALUE
rb_str_swapcase_bang(int argc, VALUE *argv, VALUE str)
{
    rb_encoding *enc;
    OnigCaseFoldType flags = ONIGENC_CASE_UPCASE | ONIGENC_CASE_DOWNCASE;

    flags = check_case_options(argc, argv, flags);
    str_modify_keep_cr(str);
    enc = str_true_enc(str);
    if (flags&ONIGENC_CASE_ASCII_ONLY)
        rb_str_ascii_casemap(str, str, &flags, enc);
    else
        str_shared_replace(str, rb_str_casemap(str, &flags, enc));

    if (ONIGENC_CASE_MODIFIED&flags) return str;
    return Qnil;
}

Upcases each lowercase character in self; downcases uppercase character; returns self if any changes were made, nil otherwise:

Example

s = 'Hello World!' # => "Hello World!"
s.swapcase!        # => "hELLO wORLD!"
s                  # => "hELLO wORLD!"
''.swapcase!       # => nil

The casing may be affected by the given options; see Case Mapping.

Related: String#swapcase.

See also #swapcase #to_c #sum #to_f also in 4.1 · 4.0 · 3.3 · 3.2 · 3.1 · 3.0

‹ prev#swapcase next ›#to_c