End of Life Ruby 3.1 has reached end of life and gets no more fixes. Switch to Ruby 4.0 →
instance method
String#casecmp
casecmp(other_string) → -1, 0, 1, or nil
string.c
View on GitHub ↗
static VALUE
rb_str_casecmp(VALUE str1, VALUE str2)
{
VALUE s = rb_check_string_type(str2);
if (NIL_P(s)) {
return Qnil;
}
return str_casecmp(str1, s);
}
Compares self.downcase and other_string.downcase; returns:
-
-1 if
other_string.downcaseis larger. -
0 if the two are equal.
-
1 if
other_string.downcaseis smaller. -
nilif the two are incomparable.
Examples:
Example
'foo'.casecmp('foo') # => 0 'foo'.casecmp('food') # => -1 'food'.casecmp('foo') # => 1 'FOO'.casecmp('foo') # => 0 'foo'.casecmp('FOO') # => 0 'foo'.casecmp(1) # => nil
See Case Mapping.
Related: String#casecmp?.