Preview Ruby 4.1 is a preview. It can change before the final release. Switch to Ruby 4.0 →
instance method
String#capitalize!
() -> self?
(:ascii | :lithuanian | :turkic) -> self?
(:lithuanian, :turkic) -> self?
(:turkic, :lithuanian) -> self?
capitalize!(mapping = :ascii) → self or nil
string.c
View on GitHub ↗
static VALUE
rb_str_capitalize_bang(int argc, VALUE *argv, VALUE str)
{
rb_encoding *enc;
OnigCaseFoldType flags = ONIGENC_CASE_UPCASE | ONIGENC_CASE_TITLECASE;
flags = check_case_options(argc, argv, flags);
str_modify_keep_cr(str);
enc = str_true_enc(str);
if (RSTRING_LEN(str) == 0 || !RSTRING_PTR(str)) return Qnil;
if (case_option_single_p(flags, enc, str)) {
if (capitalize_single(str))
flags |= ONIGENC_CASE_MODIFIED;
}
else 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;
}
Like String#capitalize, except that:
-
Changes character casings in
self(not in a copy ofself). -
Returns
selfif any changes are made,nilotherwise.
Related: See Modifying.