MethodHandle.BindTo(Object) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Binds a value x to the first argument of a method handle, without invoking it.
[Android.Runtime.Register("bindTo", "(Ljava/lang/Object;)Ljava/lang/invoke/MethodHandle;", "GetBindTo_Ljava_lang_Object_Handler", ApiSince=26)]
public virtual Java.Lang.Invoke.MethodHandle? BindTo (Java.Lang.Object? x);[<Android.Runtime.Register("bindTo", "(Ljava/lang/Object;)Ljava/lang/invoke/MethodHandle;", "GetBindTo_Ljava_lang_Object_Handler", ApiSince=26)>]
abstract member BindTo : Java.Lang.Object -> Java.Lang.Invoke.MethodHandle
override this.BindTo : Java.Lang.Object -> Java.Lang.Invoke.MethodHandleParameters
- x
- Object
the value to bind to the first argument of the target
Returns
a new method handle which prepends the given value to the incoming argument list, before calling the original method handle
- Attributes
Remarks
Binds a value x to the first argument of a method handle, without invoking it. The new method handle adapts, as its target, the current method handle by binding it to the given argument. The type of the bound handle will be the same as the type of the target, except that a single leading reference parameter will be omitted.
When called, the bound handle inserts the given value x as a new leading argument to the target. The other arguments are also passed unchanged. What the target eventually returns is returned unchanged by the bound handle.
The reference x must be convertible to the first parameter type of the target.
(<em>Note:</em> Because method handles are immutable, the target method handle retains its original type and behavior.)
Java documentation for java.lang.invoke.MethodHandle.bindTo(java.lang.Object).
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.