1berry/ruby
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

[DOC] encodings.rdoc: universal_newline reacts to \r

Browse Source 
It wasn't clear that the mode also translates "\r" to "\n".
This commit is contained in:
Alan Wu 2022-12-21 12:34:08 -05:00
parent 95a1d1fde8
commit bba2bfc975
Notes: git 2022-12-22 18:10:49 +00:00 
Merged: https://github.com/ruby/ruby/pull/6981
1 changed files with 6 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
doc/encodings.rdoc
View File

@ -467,12 +467,13 @@ These keyword-value pairs specify encoding options:
with a carriage-return character (<tt>"\r"</tt>).
- <tt>:crlf_newline: true</tt>: Replace each line-feed character (<tt>"\n"</tt>)
with a carriage-return/line-feed string (<tt>"\r\n"</tt>).
- <tt>:universal_newline: true</tt>: Replace each carriage-return/line-feed string
- <tt>:universal_newline: true</tt>: Replace each carriage-return
character (<tt>"\r"</tt>) and each carriage-return/line-feed string
(<tt>"\r\n"</tt>) with a line-feed character (<tt>"\n"</tt>).
Examples:
s = "\n \r\n" # => "\n \r\n"
s.encode('ASCII', cr_newline: true) # => "\r \r\r"
s.encode('ASCII', crlf_newline: true) # => "\r\n \r\r\n"
s.encode('ASCII', universal_newline: true) # => "\n \n"
s = "\n \r \r\n" # => "\n \r \r\n"
s.encode('ASCII', cr_newline: true) # => "\r \r \r\r"
s.encode('ASCII', crlf_newline: true) # => "\r\n \r \r\r\n"
s.encode('ASCII', universal_newline: true) # => "\n \n \n"