kotovalexarian-likes-github/ruby--ruby
1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
Code Releases Activity

* io.c: Improve Documentation by @dapplebeforedawn.

Browse source 
[fix GH-658] [ruby-core:63579] [Bug #10012]

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@46781 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
hsbt 2014-07-11 06:41:44 +00:00
parent 72d0536606
commit dcf296f74c
2 changed files with 22 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
ChangeLog
View file

@ -1,3 +1,8 @@
Fri Jul 11 15:39:36 2014 SHIBATA Hiroshi <shibata.hiroshi@gmail.com>
* io.c: Improve Documentation by @dapplebeforedawn.
[fix GH-658] [ruby-core:63579] [Bug #10012]
Fri Jul 11 14:19:14 2014 Marc-Andre Lafortune <ruby-core@marc-andre.ca> Fri Jul 11 14:19:14 2014 Marc-Andre Lafortune <ruby-core@marc-andre.ca>
* lib/matrix.rb: Fix sign for cross_product [#9499] * lib/matrix.rb: Fix sign for cross_product [#9499]

31
io.c
View file

@ -9730,38 +9730,41 @@ seek_before_access(VALUE argp)
/* /*
* call-seq: * call-seq:
* IO.read(name, [length [, offset]] ) -> string * IO.read(name, [length [, offset]] [, opt] ) -> string
* IO.read(name, [length [, offset]], open_args) -> string
* *
* Opens the file, optionally seeks to the given +offset+, then returns * Opens the file, optionally seeks to the given +offset+, then returns
* +length+ bytes (defaulting to the rest of the file). <code>read</code> * +length+ bytes (defaulting to the rest of the file). <code>read</code>
* ensures the file is closed before returning. * ensures the file is closed before returning.
* *
* If the last argument is a hash, it specifies option for internal * === Options
* open(). The key would be the following. open_args: is exclusive *
* to others. * The options hash accepts the following keys:
* *
* encoding:: * encoding::
* string or encoding * string or encoding
* *
* specifies encoding of the read string. +encoding+ will be ignored * Specifies the encoding of the read string. +encoding:+ will be ignored
* if length is specified. * if +length+ is specified. See Encoding.aliases for possible encodings.
* *
* mode:: * mode::
* string * string
* *
* specifies mode argument for open(). It should start with "r" * Specifies the mode argument for open(). It must start with an "r"
* otherwise it will cause an error. * otherwise it will cause an error. See IO.new for the list of possible
* modes.
* *
* open_args:: array of strings * open_args::
* array of strings
* *
* specifies arguments for open() as an array. * Specifies arguments for open() as an array. This key can not be used
* in combination with either +encoding:+ or +mode:+.
* *
* Examples: * Examples:
* *
* IO.read("testfile") #=> "This is line one\nThis is line two\nThis is line three\nAnd so on...\n" * IO.read("testfile") #=> "This is line one\nThis is line two\nThis is line three\nAnd so on...\n"
* IO.read("testfile", 20) #=> "This is line one\nThi" * IO.read("testfile", 20) #=> "This is line one\nThi"
* IO.read("testfile", 20, 10) #=> "ne one\nThis is line " * IO.read("testfile", 20, 10) #=> "ne one\nThis is line "
* IO.read("binfile", mode: "rb") #=> "\xF7\x00\x00\x0E\x12"
*/ */
static VALUE static VALUE