archive/ruby
1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2025-08-15 13:39:04 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

[DOC] Tweaks for String#force_encoding

Browse source
This commit is contained in:
BurdetteLamar 2025-07-30 13:13:43 -05:00 • committed by Peter Zhu
parent 6d466a55bd
commit d7bc1378d2
1 changed files with 8 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

13
doc/string/force_encoding.rdoc
View file

@ -1,5 +1,6 @@
Changes the encoding of +self+ to +encoding+,
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ł'
@ -7,14 +8,14 @@ returns self:
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.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
s.force_encoding(Encoding::UTF_8) # => "łał"
s.valid_encoding? # => true
See {Encodings}[rdoc-ref:encodings.rdoc].
Related: see {Modifying}[rdoc-ref:String@Modifying].