Gecko [ beriskala.com ]

Name	Size	Permission	Date
images	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
irb	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
pty	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
syntax	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
ChangeLog	3.88 KB	-rw-r--r--	2026-03-27 01:23
ChangeLog-0.06_to_0.52	46.51 KB	-rw-r--r--	2026-03-27 01:23
ChangeLog-0.50_to_0.60	18.81 KB	-rw-r--r--	2026-03-27 01:23
ChangeLog-0.60_to_1.1	129.14 KB	-rw-r--r--	2026-03-27 01:23
ChangeLog-1.8.0	728.09 KB	-rw-r--r--	2026-03-27 01:23
ChangeLog-1.9.3	2.86 MB	-rw-r--r--	2026-03-27 01:23
ChangeLog-2.0.0	830.16 KB	-rw-r--r--	2026-03-27 01:23
ChangeLog-2.1.0	603.56 KB	-rw-r--r--	2026-03-27 01:23
ChangeLog-2.2.0	401.16 KB	-rw-r--r--	2026-03-27 01:23
ChangeLog-2.3.0	400.93 KB	-rw-r--r--	2026-03-27 01:23
ChangeLog-2.4.0	327.98 KB	-rw-r--r--	2026-03-27 01:23
ChangeLog-YARV	144.68 KB	-rw-r--r--	2026-03-27 01:23
README.md	3.45 KB	-rw-r--r--	2026-03-27 01:23
bsearch.rdoc	4.24 KB	-rw-r--r--	2026-03-27 01:23
bug_triaging.rdoc	4.04 KB	-rw-r--r--	2026-03-27 01:23
case_mapping.rdoc	3.16 KB	-rw-r--r--	2026-03-27 01:23
character_selectors.rdoc	3.39 KB	-rw-r--r--	2026-03-27 01:23
command_injection.rdoc	711 B	-rw-r--r--	2026-03-27 01:23
contributing.md	990 B	-rw-r--r--	2026-03-27 01:23
dig_methods.rdoc	2.57 KB	-rw-r--r--	2026-03-27 01:23
dtrace_probes.rdoc	7.42 KB	-rw-r--r--	2026-03-27 01:23
encodings.rdoc	16.19 KB	-rw-r--r--	2026-03-27 01:23
extension.ja.rdoc	73.01 KB	-rw-r--r--	2026-03-27 01:23
extension.rdoc	72.26 KB	-rw-r--r--	2026-03-27 01:23
fiber.md	6.74 KB	-rw-r--r--	2026-03-27 01:23
format_specifications.rdoc	9.9 KB	-rw-r--r--	2026-03-27 01:23
forwardable.rd.ja	2.34 KB	-rw-r--r--	2026-03-27 01:23
globals.rdoc	4.33 KB	-rw-r--r--	2026-03-27 01:23
implicit_conversion.rdoc	5.8 KB	-rw-r--r--	2026-03-27 01:23
keywords.rdoc	4.63 KB	-rw-r--r--	2026-03-27 01:23
maintainers.rdoc	10.94 KB	-rw-r--r--	2026-03-27 01:23
marshal.rdoc	11.51 KB	-rw-r--r--	2026-03-27 01:23
memory_view.md	6.51 KB	-rw-r--r--	2026-03-27 01:23
packed_data.rdoc	18.51 KB	-rw-r--r--	2026-03-27 01:23
ractor.md	26.16 KB	-rw-r--r--	2026-03-27 01:23
regexp.rdoc	31.43 KB	-rw-r--r--	2026-03-27 01:23
ruby-exercise.stp	1.08 KB	-rw-r--r--	2026-04-07 17:32
security.rdoc	5.72 KB	-rw-r--r--	2026-03-27 01:23
signals.rdoc	3.33 KB	-rw-r--r--	2026-03-27 01:23
standard_library.rdoc	5.94 KB	-rw-r--r--	2026-03-27 01:23
strftime_formatting.rdoc	16.38 KB	-rw-r--r--	2026-03-27 01:23
syntax.rdoc	1.21 KB	-rw-r--r--	2026-03-27 01:23
timezones.rdoc	3.58 KB	-rw-r--r--	2026-03-27 01:23
transcode.rdoc	2.02 KB	-rw-r--r--	2026-03-27 01:23
yarvarch.en	106 B	-rw-r--r--	2026-03-27 01:23
yarvarch.ja	16.41 KB	-rw-r--r--	2026-03-27 01:23

Rename

== Case Mapping

Some string-oriented methods use case mapping.

In String:

- String#capitalize
- String#capitalize!
- String#casecmp
- String#casecmp?
- String#downcase
- String#downcase!
- String#swapcase
- String#swapcase!
- String#upcase
- String#upcase!

In Symbol:

- Symbol#capitalize
- Symbol#casecmp
- Symbol#casecmp?
- Symbol#downcase
- Symbol#swapcase
- Symbol#upcase

=== Default Case Mapping

By default, all of these methods use full Unicode case mapping,
which is suitable for most languages.
See {Section 3.13 (Default Case Algorithms) of the Unicode standard}[https://www.unicode.org/versions/latest/ch03.pdf].

Non-ASCII case mapping and folding are supported for UTF-8,
UTF-16BE/LE, UTF-32BE/LE, and ISO-8859-1~16 Strings/Symbols.

Context-dependent case mapping as described in
{Table 3-17 (Context Specification for Casing) of the Unicode standard}[https://www.unicode.org/versions/latest/ch03.pdf]
is currently not supported.

In most cases, case conversions of a string have the same number of characters.
There are exceptions (see also +:fold+ below):

s = "\u00DF" # => "ß"
  s.upcase     # => "SS"
  s = "\u0149" # => "ŉ"
  s.upcase     # => "ʼN"

Case mapping may also depend on locale (see also +:turkic+ below):

s = "\u0049"        # => "I"
  s.downcase          # => "i" # Dot above.
  s.downcase(:turkic) # => "ı" # No dot above.

Case changes may not be reversible:

s = 'Hello World!' # => "Hello World!"
  s.downcase         # => "hello world!"
  s.downcase.upcase  # => "HELLO WORLD!" # Different from original s.

Case changing methods may not maintain Unicode normalization.
See String#unicode_normalize).

=== Options for Case Mapping

Except for +casecmp+ and +casecmp?+,
each of the case-mapping methods listed above
accepts optional arguments, <tt>*options</tt>.

The arguments may be:

- +:ascii+ only.
- +:fold+ only.
- +:turkic+ or +:lithuanian+ or both.

The options:

- +:ascii+:
  ASCII-only mapping:
  uppercase letters ('A'..'Z') are mapped to lowercase letters ('a'..'z);
  other characters are not changed

s = "Foo \u00D8 \u00F8 Bar" # => "Foo Ø ø Bar"
    s.upcase                    # => "FOO Ø Ø BAR"
    s.downcase                  # => "foo ø ø bar"
    s.upcase(:ascii)            # => "FOO Ø ø BAR"
    s.downcase(:ascii)          # => "foo Ø ø bar"

- +:turkic+:
  Full Unicode case mapping, adapted for the Turkic languages
  that distinguish dotted and dotless I, for example Turkish and Azeri.

s = 'Türkiye'       # => "Türkiye"
    s.upcase            # => "TÜRKIYE"
    s.upcase(:turkic)   # => "TÜRKİYE" # Dot above.

s = 'TÜRKIYE'       # => "TÜRKIYE"
    s.downcase          # => "türkiye"
    s.downcase(:turkic) # => "türkıye" # No dot above.

- +:lithuanian+:
  Not yet implemented.

- +:fold+ (available only for String#downcase, String#downcase!,
  and Symbol#downcase):
  Unicode case folding,
  which is more far-reaching than Unicode case mapping.

s = "\u00DF"      # => "ß"
    s.downcase        # => "ß"
    s.downcase(:fold) # => "ss"
    s.upcase          # => "SS"

s = "\uFB04"      # => "ﬄ"
    s.downcase        # => "ﬄ"
    s.upcase          # => "FFL"
    s.downcase(:fold) # => "ffl"