From: ary@...
Date: 2015-08-05T09:48:52+00:00
Subject: [ruby-core:70248] [Ruby trunk - Bug #11417] [Open] Wrong description for `limit` parameter for IO#gets

Issue #11417 has been reported by Ary Borenszweig.

----------------------------------------
Bug #11417: Wrong description for `limit` parameter for IO#gets
https://bugs.ruby-lang.org/issues/11417

* Author: Ary Borenszweig
* Status: Open
* Priority: Normal
* Assignee: 
* ruby -v: 
* Backport: 2.0.0: UNKNOWN, 2.1: UNKNOWN, 2.2: UNKNOWN
----------------------------------------
It says:

"If the first argument is an integer, or optional second argument is given, the returning string would not be longer than the given value in bytes."

But:

~~~
require "stringio"

io = StringIO.new "���������������"
string = io.gets(1)
puts string #=> "���"
puts string.bytes.length #=> 3
~~~

The returning value number of bytes (3) is longer than the given value (1), so it contradicts the description.

I guess the implementation reads chars until the total number of bytes read is equal or bigger than the limit.

But I don't know how to describe this behaviour in a way that's clear to the user.




-- 
https://bugs.ruby-lang.org/