diff options
author | stomar <stomar@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2017-03-22 20:23:42 +0000 |
---|---|---|
committer | stomar <stomar@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2017-03-22 20:23:42 +0000 |
commit | 5f5f648c9bc6cf7fb5be708c3975fb3c67aec42e (patch) | |
tree | c596d7e4474538bb37b612a1430e306755a553fd /io.c | |
parent | 028bd4ae15b809625906967ca2c100ce7f3aa850 (diff) | |
download | ruby-5f5f648c9bc6cf7fb5be708c3975fb3c67aec42e.tar.gz |
io.c: [DOC] expand docs for IO#puts
[ruby-core:80081] [Bug #13306]
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@58062 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Diffstat (limited to 'io.c')
-rw-r--r-- | io.c | 13 |
1 files changed, 9 insertions, 4 deletions
@@ -7185,15 +7185,17 @@ io_puts_ary(VALUE ary, VALUE out, int recur) * call-seq: * ios.puts(obj, ...) -> nil * - * Writes the given object(s) to <em>ios</em> as with <code>IO#write</code>. + * Writes the given object(s) to <em>ios</em>. * Writes a newline after any that do not already end - * with a newline sequence. + * with a newline sequence. Returns +nil+. * + * The stream must be opened for writing. * If called with an array argument, writes each element on a new line. + * Each given object that isn't a string or array will be converted + * by calling its +to_s+ method. * If called without arguments, outputs a single newline. - * This doesn't affect $/. ($RS or $INPUT_RECORD_SEPARATOR in English.rb) * - * $stdout.puts("this", "is", "a", "test") + * $stdout.puts("this", "is", ["a", "test"]) * * <em>produces:</em> * @@ -7201,6 +7203,9 @@ io_puts_ary(VALUE ary, VALUE out, int recur) * is * a * test + * + * Note that +puts+ always uses newlines and is not affected + * by the output record separator (<code>$\\</code>). */ VALUE |