Merge pull request #2286 from znz/bind_call

Add UnboundMethod#bind_call since 2.7.0

Author: znz

refm/api/src/_builtin/Method

@@ -118,6 +118,9 @@ self[] の形の呼び出しは通常のメソッド呼び出しに見た目を
 
 @param args self に渡される引数。
 
+#@since 2.7.0
+@see [[m:UnboundMethod#bind_call]]
+#@end
 @see [[d:spec/safelevel]]
 #@# セーフレベルに関するその他の詳細
 

refm/api/src/_builtin/UnboundMethod

@@ -99,6 +99,21 @@ NOTE: Ruby 1.8.xでモジュールのインスタンスメソッドをbindする
     end
     p m.bind(Bar.new)               # => #<Method: Bar(Foo)#foo>
 
+#@since 2.7.0
+@see [[m:UnboundMethod#bind_call]]
+--- bind_call(recv, *args) -> object
+--- bind_call(recv, *args) { ... } -> object
+
+self を recv に bind して args を引数として呼び出します。
+
+self.bind(recv).call(*args) と同じ意味です。
+
+#@samplecode
+puts Kernel.instance_method(:inspect).bind_call(BasicObject.new) # => #<BasicObject:0x000055c65e8ea7b8>
+#@end
+
+@see [[m:UnboundMethod#bind]], [[m:Method#call]]
+#@end
 --- arity    -> Integer
 
 メソッドが受け付ける引数の数を返します。