String#casecmp and String#casecmp? behave differently from other comparison methods: for incomparable values they raise a TypeError, while Symbol#{casecmp,casecmp?} and the #<=> methods (also for other classes) return nil:
"abc"<=>1# => nil"abc".casecmp1# TypeError: no implicit conversion of Integer into String"abc".casecmp?1# TypeError: no implicit conversion of Integer into String:abc<=>1# => nil:abc.casecmp1# => nil:abc.casecmp?1# => nil1<=>Time.now# => nil[]<=>:foo# => nil
This is surprising, since String#casecmp is essentially a case-insensitive version of String#<=>, which seems to imply that they should behave in a similar way. Also, the different behavior for String and Symbol might be an indication that this is a bug and not intentional.
I did not include the type check in str_casecmp, which seems superfluous to me. I also adjusted the tests, docs, and examples to those of the corresponding Symbol methods, and fixed the code formatting.
I also added a NEWS entry and updated the specs with a version guard for 2.5 (I do not know how this would be handled in case the change should be backported).
I also added a NEWS entry and updated the specs with a version guard for 2.5 (I do not know how this would be handled in case the change should be backported).
Thanks, r58839 looks great.
In case of backport we can adjust the version guard, but only after a release of 2.x as we need to test against releases in ruby/spec Travis and locally.
Backport changed from 2.2: UNKNOWN, 2.3: UNKNOWN, 2.4: UNKNOWN to 2.2: WONTFIX, 2.3: WONTFIX, 2.4: UNKNOWN
I think this change may not cause any compatibility issue with real-world scripts, but it means that nobody hits this problem, too.
Then I decided not to backport to ruby_2_3.