ruby/doc/string/force_encoding.rdoc
2025-07-31 09:13:57 -04:00

21 lines
726 B
Text

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].