com.oracle.truffle.api.interop

Class ArityException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.oracle.truffle.api.interop.InteropException

com.oracle.truffle.api.interop.ArityException

All Implemented Interfaces:

Serializable

public final class ArityException
extends InteropException

An exception thrown if a foreign function or method invocation provides the wrong number of arguments.

Since:

0.11

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
int	getActualArity() Returns the actual number of arguments provided by the foreign access.
int	getExpectedArity() Returns the number of arguments that the foreign object expects.
static RuntimeException	raise(int expectedArity, int actualArity) Raises an ArityException, hidden as a RuntimeException, which allows throwing it without an explicit throws declaration.

Methods inherited from class com.oracle.truffle.api.interop.InteropException

raise

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

getExpectedArity

public int getExpectedArity()

Returns the number of arguments that the foreign object expects.

Returns:

the number of expected arguments

Since:

0.11

getActualArity

public int getActualArity()

Returns the actual number of arguments provided by the foreign access.

Returns:

the number of provided arguments

Since:

0.11

raise

public static RuntimeException raise(int expectedArity,
                                     int actualArity)

Raises an ArityException, hidden as a RuntimeException, which allows throwing it without an explicit throws declaration. The ForeignAccess methods (e.g. ForeignAccess.sendRead ) catch the exceptions and re-throw them as checked exceptions.

Parameters:

expectedArity - the number of arguments expected by the foreign object

actualArity - the number of provided by the foreign access

Returns:

the exception

Since:

0.11