File: casecmp.rdoc

package info (click to toggle)
ruby3.3 3.3.8-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 153,620 kB
  • sloc: ruby: 1,244,308; ansic: 836,474; yacc: 28,074; pascal: 6,748; sh: 3,913; python: 1,719; cpp: 1,158; makefile: 742; asm: 712; javascript: 394; lisp: 97; perl: 62; awk: 36; sed: 23; xml: 4
file content (27 lines) | stat: -rw-r--r-- 727 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
Like Symbol#<=>, but case-insensitive;
equivalent to <tt>self.to_s.casecmp(object.to_s)</tt>:

  lower = :abc
  upper = :ABC
  upper.casecmp(lower) # => 0
  lower.casecmp(lower) # => 0
  lower.casecmp(upper) # => 0

Returns nil if +self+ and +object+ have incompatible encodings,
or if +object+ is not a symbol:

  sym = 'äöü'.encode("ISO-8859-1").to_sym
  other_sym = 'ÄÖÜ'
  sym.casecmp(other_sym) # => nil
  :foo.casecmp(2)        # => nil

Unlike Symbol#casecmp?,
case-insensitivity does not work for characters outside of 'A'..'Z' and 'a'..'z':

  lower = :äöü
  upper = :ÄÖÜ
  upper.casecmp(lower) # => -1
  lower.casecmp(lower) # => 0
  lower.casecmp(upper) # => 1

Related: Symbol#casecmp?, String#casecmp.