com.oracle.truffle.espresso.polyglot

Class InvalidBufferOffsetException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.oracle.truffle.espresso.polyglot.InteropException

com.oracle.truffle.espresso.polyglot.InvalidBufferOffsetException

All Implemented Interfaces:

Serializable

public final class InvalidBufferOffsetException
extends InteropException

An exception thrown if a buffer access if out of bounds.

Since:

21.1

See Also:

InvalidBufferOffsetException.getByteOffset(), InvalidBufferOffsetException.getLength(), Serialized Form

Method Summary

Modifier and Type	Method and Description
static InvalidBufferOffsetException	create(long byteOffset, long length) Creates an InvalidBufferOffsetException to indicate that a buffer access is invalid.
static InvalidBufferOffsetException	create(long byteOffset, long length, Throwable cause) Creates an InvalidBufferOffsetException to indicate that a buffer access is invalid.
long	getByteOffset() Returns the start byte offset of the invalid access from the start of the buffer.
long	getLength() Returns the length of the accessed memory region in bytes starting from the start byte offset.
String	getMessage()

Methods inherited from class com.oracle.truffle.espresso.polyglot.InteropException

fillInStackTrace, getCause

Methods inherited from class java.lang.Throwable

addSuppressed, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Method Detail

getByteOffset

public long getByteOffset()

Returns the start byte offset of the invalid access from the start of the buffer.

Since:

21.1

getLength

public long getLength()

Returns the length of the accessed memory region in bytes starting from the start byte offset.

Since:

21.1

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

Since:

21.1

create

public static InvalidBufferOffsetException create(long byteOffset,
                                                  long length)

Creates an InvalidBufferOffsetException to indicate that a buffer access is invalid.

Parameters:

byteOffset - the start byteOffset of the invalid access

length - the length of the accessed memory region in bytes starting from byteOffset

Since:

21.1

create

public static InvalidBufferOffsetException create(long byteOffset,
                                                  long length,
                                                  Throwable cause)

Creates an InvalidBufferOffsetException to indicate that a buffer access is invalid.

In addition a cause may be provided. The cause should only be set if the guest language code caused this problem. An example for this is a language specific proxy mechanism that invokes guest language code to describe an object. If the guest language code fails to execute and this interop exception is a valid interpretation of the error, then the error should be provided as cause.

Parameters:

byteOffset - the start byteOffset of the invalid access

length - the length of the accessed memory region in bytes starting from byteOffset.

cause - the guest language exception that caused the error.

Since:

21.1