summaryrefslogtreecommitdiff
path: root/doc/string/force_encoding.rdoc
blob: a509e67f80508e7855628f4a979d7818602f8f5f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
Changes the encoding of +self+ to the given +encoding+,
which may be a string encoding name or an Encoding object;
does not change the underlying bytes;
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>
  s.valid_encoding?         # => true
  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

See {Encodings}[rdoc-ref:encodings.rdoc].

Related: see {Modifying}[rdoc-ref:String@Modifying].