1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
ruby--ruby/doc/string/force_encoding.rdoc
Burdette Lamar 056b7a8633
[DOC] Enhanced RDoc for String (#5742)
Treats:
    #force_encoding
    #b
    #valid_encoding?
    #ascii_only?
    #scrub
    #scrub!
    #unicode_normalized?
Plus a couple of minor tweaks.
2022-03-31 15:09:25 -05:00

20 lines
686 B
Text

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