summaryrefslogtreecommitdiff
path: root/io.c
diff options
context:
space:
mode:
Diffstat (limited to 'io.c')
-rw-r--r--io.c10
1 files changed, 10 insertions, 0 deletions
diff --git a/io.c b/io.c
index 7932a68..0305386 100644
--- a/io.c
+++ b/io.c
@@ -3291,6 +3291,16 @@ rb_io_gets(VALUE io)
*
* File.new("testfile").gets #=> "This is line one\n"
* $_ #=> "This is line one\n"
+ *
+ * If StringIO contains characters more than 1 byte
+ * then <code>gets(1)</code> returns character entirely:
+ *
+ * # russian characters take 2 bytes
+ * File.write("testfile", "\u{442 435 441 442}")
+ * File.open("testfile") {|f|f.gets(1)} #=> "\u0442"
+ * File.open("testfile") {|f|f.gets(2)} #=> "\u0442"
+ * File.open("testfile") {|f|f.gets(3)} #=> "\u0442\u0435"
+ * File.open("testfile") {|f|f.gets(4)} #=> "\u0442\u0435"
*/
static VALUE