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

[DOC] Add a note to clarify binary flags to IO.new

Browse Source 
Try to make it more clear that the `File::BINARY` integer flag, and the
`b` string suffix are not equivalent.
This commit is contained in:
David Rodríguez 2022-05-20 10:23:45 +02:00 committed by GitHub
parent 6850e3c42e
commit ec7b42eb77
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
Notes: git 2022-05-20 17:24:06 +09:00 
Merged: https://github.com/ruby/ruby/pull/5923

Merged-By: nobu <nobu@ruby-lang.org>
1 changed files with 7 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
io.c
View File

@ -14212,7 +14212,7 @@ set_LAST_READ_LINE(VALUE val, ID _x, VALUE *_y)
* ==== Read/Write Mode Specified as an \Integer * ==== Read/Write Mode Specified as an \Integer
* *
* When +mode+ is an integer it must be one or more (combined by bitwise OR (<tt>|</tt>) * When +mode+ is an integer it must be one or more (combined by bitwise OR (<tt>|</tt>)
* of the modes defined in File::Constants: * of the following modes:
* *
* - +File::RDONLY+: Open for reading only. * - +File::RDONLY+: Open for reading only.
* - +File::WRONLY+: Open for writing only. * - +File::WRONLY+: Open for writing only.
@ -14277,6 +14277,12 @@ set_LAST_READ_LINE(VALUE val, ID _x, VALUE *_y)
* *
* File.open('t.tmp', 'wx') * File.open('t.tmp', 'wx')
* *
* Note that when using integer flags to set the read/write mode, it's not
* possible to also set the binary data mode by adding the File::BINARY flag
* to the bitwise OR combination of integer flags. This is because, as
* documented in File::Constants, the File::BINARY flag only disables line code
* conversion, but does not change the external encoding at all.
*
* == Encodings * == Encodings
* *
* Any of the string modes above may specify encodings -- * Any of the string modes above may specify encodings --