com.oracle.svm.core.snippets

Class KnownIntrinsics

java.lang.Object

com.oracle.svm.core.snippets.KnownIntrinsics

public class KnownIntrinsics
extends Object

Functions that are implemented as compiler intrinsics. For implementation see SubstrateGraphBuilderPlugins.registerKnownIntrinsicsPlugins().

Constructor Summary

Constructors

Constructor and Description
KnownIntrinsics()

Method Summary

Modifier and Type	Method and Description
static <T> T	castExact(Object object, Class<T> clazz) Casts the given object to the exact class represented by clazz.
static void	farReturn(Object result, org.graalvm.word.Pointer sp, org.graalvm.nativeimage.c.function.CodePointer ip, boolean fromMethodWithCalleeSavedRegisters) Continues execution in the specified caller frame, at the specified instruction pointer.
static org.graalvm.word.Pointer	heapBase() Returns the value of the heap base.
static boolean	isDeoptimizationTarget() For deoptimization testing only.
static org.graalvm.word.Pointer	nonNullPointer(org.graalvm.word.Pointer pointer) Narrow down the range of values to exclude 0 as the possible pointer value.
static org.graalvm.word.Pointer	readCallerStackPointer() Returns the value of the native stack pointer for the physical caller frame.
static DynamicHub	readHub(Object obj) Returns the hub of the given object.
static org.graalvm.nativeimage.c.function.CodePointer	readReturnAddress() Returns the value of the native instruction pointer for the physical caller frame.
static org.graalvm.word.Pointer	readStackPointer() Returns the value of the native stack pointer.
static void	testDeoptimize() For deoptimization testing only.

Methods inherited from class java.lang.Object

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

Constructor Detail

KnownIntrinsics

public KnownIntrinsics()

Method Detail

heapBase

public static org.graalvm.word.Pointer heapBase()

Returns the value of the heap base.

readHub

public static DynamicHub readHub(Object obj)

Returns the hub of the given object.

nonNullPointer

public static org.graalvm.word.Pointer nonNullPointer(org.graalvm.word.Pointer pointer)

Narrow down the range of values to exclude 0 as the possible pointer value.

Parameters:

pointer - that we are narrowing to non-null

Returns:

a pointer with stamp non-null

readStackPointer

public static org.graalvm.word.Pointer readStackPointer()

Returns the value of the native stack pointer.

readCallerStackPointer

public static org.graalvm.word.Pointer readCallerStackPointer()

Returns the value of the native stack pointer for the physical caller frame. The caller of this method must be annotated with NeverInline to ensure that the physical caller frame is deterministic.

readReturnAddress

public static org.graalvm.nativeimage.c.function.CodePointer readReturnAddress()

Returns the value of the native instruction pointer for the physical caller frame. The caller of this method must be annotated with NeverInline to ensure that the physical caller frame is deterministic.

farReturn

public static void farReturn(Object result,
                             org.graalvm.word.Pointer sp,
                             org.graalvm.nativeimage.c.function.CodePointer ip,
                             boolean fromMethodWithCalleeSavedRegisters)

Continues execution in the specified caller frame, at the specified instruction pointer. The result is placed in the register used for object results, simulating the return from a method with an Object return type. Note that this is very dangerous. You have to know what you are doing. The parameters are not checked for correctness in any way.

testDeoptimize

public static void testDeoptimize()

For deoptimization testing only. Performs a deoptimization in a regular method, but is a no-op in a deoptimization target method.

isDeoptimizationTarget

public static boolean isDeoptimizationTarget()

For deoptimization testing only. Folds to true in a deoptimization target method and to false in a deoptimization source method.

castExact

public static <T> T castExact(Object object,
                              Class<T> clazz)

Casts the given object to the exact class represented by clazz. The cast succeeds only if object == null || object.getClass() == clazz and thus fails for any subclass.

Parameters:

object - the object to be cast

clazz - the class to check against, must not be null

Returns:

the object after casting

Throws:

ClassCastException - if the object is non-null and not exactly of the given class

NullPointerException - if the class argument is null

See Also:

Class.cast(Object)