From 86f1d9b705e460960ea97b6d0084a07cb05e4023 Mon Sep 17 00:00:00 2001 From: hsbt Date: Sat, 21 Oct 2017 15:19:45 +0000 Subject: [PATCH] Clarify return value for assignment methods. https://github.com/ruby/ruby/pull/1682 Patch by @sos4nt [fix GH-1682] git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@60295 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- doc/syntax/methods.rdoc | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/syntax/methods.rdoc b/doc/syntax/methods.rdoc index bdc555b131..eff38c3410 100644 --- a/doc/syntax/methods.rdoc +++ b/doc/syntax/methods.rdoc @@ -147,7 +147,7 @@ evaluated. 1 + 1 # this expression is never evaluated end -Note that for assignment methods the return value will always be ignored. +Note that for assignment methods the return value will be ignored when using the assignment syntax. Instead, the argument will be returned: def a=(value) @@ -155,6 +155,10 @@ Instead, the argument will be returned: end p(a = 5) # prints 5 + +The actual return value will be returned when invoking the method directly: + + p send(:a=, 5) # prints 6 == Scope