Jython 3.0.0-snapshot · org.python.core.PyMethodWrapper

The Python type types.MethodWrapperType (seen also as <class 'method-wrapper'>) represents a special method bound to a particular target "self" object. It is part of the mechanism which allows a special method defined in Java to be called from Python using its name as an attribute.

An example from the wild is to evaluate: (42).__add__, binding the method __add__ to the target 42, to produce a callable equivalent to λ x . 42+x. An instance of this class results from a call to PyWrapperDescr#__get__(Object, PyType).

Modifier and Type	Field and Description
pack-priv PyWrapperDescr	descr Descriptor for the method being bound.
pack-priv final Object	self The target object of the method call that results when `__call__` is invoked on this object.
pack-priv static final PyType	TYPE

Access	Constructor and Description
pack-priv	PyMethodWrapper(PyWrapperDescr for the special method to bind descr, Object to which this method call is bound self) Bind a slot wrapper descriptor to its target.

Method Summary

Modifier and Type	Method and Description
public Object	__call__(Object[] args, String[] names)
protected Object	__doc__()
protected Object	__eq__(Object b)
protected int	__hash__()
protected Object	__name__()
protected Object	__ne__(Object b)
protected Object	__objclass__()
protected Object	__qualname__()
protected Object	__repr__()
protected Object	__text_signature__()
public Object	call(Object[] all arguments given, positional then keyword args, String[] of keyword arguments or `null` names) Implements org.python.core.FastCall.call. Invoke the target object with standard arguments (`Object[]` and `String[]`), providing all the argument values from the caller and names for those given by keyword.
public PyType	getType() Overrides org.python.core.AbstractPyObject.getType. Implements org.python.core.CraftedPyObject.getType. The Python `type` of this object.
public TypeError	typeError(ArgumentError previously thrown by this object ae, Object[] all arguments given, positional then keyword args, String[] of keyword arguments or `null` names) Implements org.python.core.FastCall.typeError. Translate an `ArgumentError` that resulted from a call to this `FastCall` object, and the arguments that were supplied in the call, to a Python `TypeError`.

Inherited from org.python.core.AbstractPyObject:: toString

Field Detail

descr	back to summary
pack-priv PyWrapperDescr descr Descriptor for the method being bound. Annotations @Member

self	back to summary
pack-priv final Object self The target object of the method call that results when `__call__` is invoked on this object. This is exposed to Python as `__self__`. Annotations @Member:__self__

TYPE	back to summary
pack-priv static final PyType TYPE

Constructor Detail

PyMethodWrapper back to summary

PyMethodWrapper	back to summary
pack-priv PyMethodWrapper(PyWrapperDescr descr, Object self) Bind a slot wrapper descriptor to its target. The result is a callable object e.g. in `bark = "Woof!".__mul__`, `bark` will be an instance of this class, `"Woof!`" is `self` and `str.__mul__` is the descriptor. Parameters descr:PyWrapperDescr for the special method to bind self:Object to which this method call is bound

pack-priv PyMethodWrapper(PyWrapperDescr descr, Object self)

Bind a slot wrapper descriptor to its target. The result is a callable object e.g. in bark = "Woof!".__mul__, bark will be an instance of this class, "Woof!" is self and str.__mul__ is the descriptor.

Parameters

descr:PyWrapperDescr: for the special method to bind
self:Object: to which this method call is bound

Method Detail

__call__	back to summary
public Object __call__(Object[] args, String[] names) throws Throwable

__doc__	back to summary
protected Object __doc__()

__eq__	back to summary
protected Object __eq__(Object b)

__hash__	back to summary
protected int __hash__()

__name__	back to summary
protected Object __name__()

__ne__	back to summary
protected Object __ne__(Object b)

__objclass__	back to summary
protected Object __objclass__()

__qualname__	back to summary
protected Object __qualname__() throws AttributeError, Throwable

__repr__	back to summary
protected Object __repr__()

__text_signature__	back to summary
protected Object __text_signature__()

call back to summary

call	back to summary
public Object call(Object[] args, String[] names) throws Throwable Implements org.python.core.FastCall.call. Doc from org.python.core.FastCall.call. Invoke the target object with standard arguments (`Object[]` and `String[]`), providing all the argument values from the caller and names for those given by keyword. If no other methods are implemented, a call to any other interface method will land here with an array of the arguments.This is to provide implementations of `__call__` with a default when no more optimal call is possible. `np = args.length - names.length` arguments are given by position, and the keyword arguments are {`names[i]:args[np+i]`}. Parameters args:Object[] all arguments given, positional then keyword names:String[] of keyword arguments or `null` Returns:Object result of the invocation Annotations @Override Exceptions Throwable: from the implementation

public Object call(Object[] args, String[] names) throws Throwable

Implements org.python.core.FastCall.call.

Doc from org.python.core.FastCall.call.

Invoke the target object with standard arguments (Object[] and String[]), providing all the argument values from the caller and names for those given by keyword. If no other methods are implemented, a call to any other interface method will land here with an array of the arguments.This is to provide implementations of __call__ with a default when no more optimal call is possible.

np = args.length - names.length arguments are given by position, and the keyword arguments are {names[i]:args[np+i]}.

Parameters

args:Object[]: all arguments given, positional then keyword
names:String[]: of keyword arguments or null

Returns:Object

result of the invocation

Annotations

@Override

Exceptions

Throwable:: from the implementation

getType back to summary

getType	back to summary
public PyType getType() Overrides org.python.core.AbstractPyObject.getType. Implements org.python.core.CraftedPyObject.getType. Doc from org.python.core.CraftedPyObject.getType. The Python `type` of this object. Returns:PyType `type` of this object Annotations @Override

public PyType getType()

Overrides org.python.core.AbstractPyObject.getType.

Implements org.python.core.CraftedPyObject.getType.

Doc from org.python.core.CraftedPyObject.getType.

The Python type of this object.

Returns:PyType

type of this object

Annotations

@Override

typeError back to summary

typeError	back to summary
public TypeError typeError(ArgumentError ae, Object[] args, String[] names) Implements org.python.core.FastCall.typeError. Doc from org.python.core.FastCall.typeError. Translate an `ArgumentError` that resulted from a call to this `FastCall` object, and the arguments that were supplied in the call, to a Python `TypeError`. Any of the optimised `call(...)`, or `vectorcall(...)` methods in this interface may throw `ArgumentError` as a shorthand. (This is to keep code short, especially when it is a handle graph.) The caller should catch this close to the call and use this method to swap the `ArgumentError` for a Python `TypeError`. Parameters ae:ArgumentError previously thrown by this object args:Object[] all arguments given, positional then keyword names:String[] of keyword arguments or `null` Returns:TypeError Python `TypeError` to throw Annotations @Override

public TypeError typeError(ArgumentError ae, Object[] args, String[] names)

Implements org.python.core.FastCall.typeError.

Doc from org.python.core.FastCall.typeError.

Translate an ArgumentError that resulted from a call to this FastCall object, and the arguments that were supplied in the call, to a Python TypeError.

Any of the optimised call(...), or vectorcall(...) methods in this interface may throw ArgumentError as a shorthand. (This is to keep code short, especially when it is a handle graph.) The caller should catch this close to the call and use this method to swap the ArgumentError for a Python TypeError.

Parameters

ae:ArgumentError: previously thrown by this object
args:Object[]: all arguments given, positional then keyword
names:String[]: of keyword arguments or null

Returns:TypeError

Python TypeError to throw

Annotations

@Override

pack-priv Class PyMethodWrapper

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail