File: casecmp_p.rdoc

package info (click to toggle)
ruby3.4 3.4.5-1~exp1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 154,784 kB
  • sloc: ruby: 1,259,653; ansic: 829,955; yacc: 28,233; pascal: 7,359; sh: 3,864; python: 1,799; cpp: 1,158; asm: 808; makefile: 801; javascript: 414; lisp: 109; perl: 62; awk: 36; sed: 4; xml: 4
file content (26 lines) | stat: -rw-r--r-- 725 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
Returns +true+ if +self+ and +object+ are equal after Unicode case folding,
otherwise +false+:

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

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, works for characters outside of 'A'..'Z' and 'a'..'z':

  lower = :äöü
  upper = :ÄÖÜ
  upper.casecmp?(lower) # => true
  lower.casecmp?(lower) # => true
  lower.casecmp?(upper) # => true

Related: Symbol#casecmp, String#casecmp?.