instance method

String#clear

() -> self

clear → self

static VALUE
rb_str_clear(VALUE str)
{
    str_discard(str);
    STR_SET_EMBED(str);
    STR_SET_LEN(str, 0);
    RSTRING_PTR(str)[0] = 0;
    if (rb_enc_asciicompat(STR_ENC_GET(str)))
        ENC_CODERANGE_SET(str, ENC_CODERANGE_7BIT);
    else
        ENC_CODERANGE_SET(str, ENC_CODERANGE_VALID);
    return str;
}

Removes the contents of self:

Example

s = 'foo'
s.clear # => ""
s       # => ""

Related: see Modifying.

See also #chr #codepoints #chop! #concat also in 4.1 · 3.4 · 3.3 · 3.2 · 3.1 · 3.0

‹ prev#chr next ›#codepoints