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	18.15 KB	-rw-r--r--	2026-03-26 03:35
README.md	3.64 KB	-rw-r--r--	2026-03-26 03:35
_regexp.rdoc	43.58 KB	-rw-r--r--	2026-03-26 03:35
_timezones.rdoc	5.54 KB	-rw-r--r--	2026-03-26 03:35
bsearch.rdoc	4.24 KB	-rw-r--r--	2026-03-26 03:35
bug_triaging.rdoc	4.04 KB	-rw-r--r--	2026-03-26 03:35
case_mapping.rdoc	3.15 KB	-rw-r--r--	2026-03-26 03:35
character_selectors.rdoc	3.38 KB	-rw-r--r--	2026-03-26 03:35
command_injection.rdoc	745 B	-rw-r--r--	2026-03-26 03:35
contributing.md	990 B	-rw-r--r--	2026-03-26 03:35
dig_methods.rdoc	2.57 KB	-rw-r--r--	2026-03-26 03:35
distribution.md	2.03 KB	-rw-r--r--	2026-03-26 03:35
dtrace_probes.rdoc	7.42 KB	-rw-r--r--	2026-03-26 03:35
encodings.rdoc	16.27 KB	-rw-r--r--	2026-03-26 03:35
extension.ja.rdoc	73.03 KB	-rw-r--r--	2026-03-26 03:35
extension.rdoc	74.62 KB	-rw-r--r--	2026-03-26 03:35
fiber.md	6.74 KB	-rw-r--r--	2026-03-26 03:35
format_specifications.rdoc	9.87 KB	-rw-r--r--	2026-03-26 03:35
forwardable.rd.ja	2.34 KB	-rw-r--r--	2026-03-26 03:35
globals.rdoc	8.46 KB	-rw-r--r--	2026-03-26 03:35
implicit_conversion.rdoc	5.8 KB	-rw-r--r--	2026-03-26 03:35
keywords.rdoc	4.63 KB	-rw-r--r--	2026-03-26 03:35
maintainers.md	11.22 KB	-rw-r--r--	2026-03-26 03:35
marshal.rdoc	11.51 KB	-rw-r--r--	2026-03-26 03:35
memory_view.md	6.51 KB	-rw-r--r--	2026-03-26 03:35
packed_data.rdoc	18.76 KB	-rw-r--r--	2026-03-26 03:35
ractor.md	26.16 KB	-rw-r--r--	2026-03-26 03:35
ruby-exercise.stp	1.08 KB	-rw-r--r--	2026-04-07 17:01
security.rdoc	5.72 KB	-rw-r--r--	2026-03-26 03:35
signals.rdoc	3.33 KB	-rw-r--r--	2026-03-26 03:35
standard_library.rdoc	6.58 KB	-rw-r--r--	2026-03-26 03:35
strftime_formatting.rdoc	16.36 KB	-rw-r--r--	2026-03-26 03:35
syntax.rdoc	1.29 KB	-rw-r--r--	2026-03-26 03:35
windows.md	5.91 KB	-rw-r--r--	2026-03-26 03:35
yarvarch.en	106 B	-rw-r--r--	2026-03-26 03:35
yarvarch.ja	16.41 KB	-rw-r--r--	2026-03-26 03:35

Rename

= Character Selectors

== Character Selector

A _character_ _selector_ is a string argument accepted by certain Ruby methods.
Each of these instance methods accepts one or more character selectors:

- String#tr(selector, replacements): returns a new string.
- String#tr!(selector, replacements): returns +self+ or +nil+.
- String#tr_s(selector, replacements): returns a new string.
- String#tr_s!(selector, replacements): returns +self+ or +nil+.
- String#count(*selectors): returns the count of the specified characters.
- String#delete(*selectors): returns a new string.
- String#delete!(*selectors): returns +self+ or +nil+.
- String#squeeze(*selectors): returns a new string.
- String#squeeze!(*selectors): returns +self+ or +nil+.

A character selector identifies zero or more characters in +self+
that are to be operands for the method.

In this section, we illustrate using method String#delete(selector),
which deletes the selected characters.

In the simplest case, the characters selected are exactly those
contained in the selector itself:

'abracadabra'.delete('a')   # => "brcdbr"
  'abracadabra'.delete('ab')  # => "rcdr"
  'abracadabra'.delete('abc') # => "rdr"
  '0123456789'.delete('258')  # => "0134679"
  '!@#$%&*()_+'.delete('+&#') # => "!@$%*()_"
  'тест'.delete('т')          # => "ес"
  'こんにちは'.delete('に')     # => "こんちは"

Note that order and repetitions do not matter:

'abracadabra'.delete('dcab') # => "rr"
  'abracadabra'.delete('aaaa') # => "brcdbr"

In a character selector, these three characters get special treatment:

- A leading caret (<tt>'^'</tt>) functions as a "not" operator
  for the characters to its right:

'abracadabra'.delete('^bc') # => "bcb"
    '0123456789'.delete('^852') # => "258"

- A hyphen (<tt>'-'</tt>) between two other characters
  defines a range of characters instead of a plain string of characters:

'abracadabra'.delete('a-d') # => "rr"
    '0123456789'.delete('4-7')  # => "012389"
    '!@#$%&*()_+'.delete(' -/') # => "@^_"

# May contain more than one range.
    'abracadabra'.delete('a-cq-t') # => "d"

# Ranges may be mixed with plain characters.
    '0123456789'.delete('67-950-23') # => "4"

# Ranges may be mixed with negations.
    'abracadabra'.delete('^a-c') # => "abacaaba"

- A backslash (<tt>'\'</tt>) acts as an escape for a caret, a hyphen,
  or another backslash:

'abracadabra^'.delete('\^bc')   # => "araadara"
    'abracadabra-'.delete('a\-d')   # => "brcbr"
    "hello\r\nworld".delete("\r")   # => "hello\nworld"
    "hello\r\nworld".delete("\\r")  # => "hello\r\nwold"
    "hello\r\nworld".delete("\\\r") # => "hello\nworld"

== Multiple Character Selectors

These instance methods accept multiple character selectors:

- String#count(*selectors): returns the count of the specified characters.
- String#delete(*selectors): returns a new string.
- String#delete!(*selectors): returns +self+ or +nil+.
- String#squeeze(*selectors): returns a new string.
- String#squeeze!(*selectors): returns +self+ or +nil+.

In effect, the given selectors are formed into a single selector
consisting of only those characters common to _all_ of the given selectors.

All forms of selectors may be used, including negations, ranges, and escapes.

Each of these pairs of method calls is equivalent:

s.delete('abcde', 'dcbfg')
  s.delete('bcd')

s.delete('^abc', '^def')
  s.delete('^abcdef')

s.delete('a-e', 'c-g')
  s.delete('cde')