File: force_encoding.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 (20 lines) | stat: -rw-r--r-- 686 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
Changes the encoding of +self+ to +encoding+,
which may be a string encoding name or an Encoding object;
returns self:

  s = 'łał'
  s.bytes                   # => [197, 130, 97, 197, 130]
  s.encoding                # => #<Encoding:UTF-8>
  s.force_encoding('ascii') # => "\xC5\x82a\xC5\x82"
  s.encoding                # => #<Encoding:US-ASCII>

Does not change the underlying bytes:

  s.bytes                   # => [197, 130, 97, 197, 130]

Makes the change even if the given +encoding+ is invalid
for +self+ (as is the change above):

  s.valid_encoding?                 # => false
  s.force_encoding(Encoding::UTF_8) # => "łał"
  s.valid_encoding?                 # => true