com.oracle.truffle.api.instrumentation

Class StandardTags.ExpressionTag

java.lang.Object

com.oracle.truffle.api.instrumentation.Tag

com.oracle.truffle.api.instrumentation.StandardTags.ExpressionTag

Enclosing class:

StandardTags

public static final class StandardTags.ExpressionTag
extends Tag

Marks program locations as to be considered expressions of the languages. Common examples for expressions are:

• Literal expressions
• Arithmetic expressions like addition and multiplication
• Condition expressions
• Function calls
• Array, Object or variable reads and writes
• Instantiations

Use case descriptions:

• Coverage: To compute expression coverage.
• Debugger: Fine grained debugging of expressions. It is optional to implement the expression tag to support debuggers.

The ExpressionTag uses the identifier "EXPRESSION". A node tagged with StandardTags.RootTag must provide a source section, if its root node provides a source section. *

If the a node tagged with root returns a non null value then it must be an interop value. There are assertions in place verifying this when Java assertions are enabled (-ea).

Since:

0.33

Nested Class Summary

Nested classes/interfaces inherited from class com.oracle.truffle.api.instrumentation.Tag

Tag.Identifier

Method Summary

Methods inherited from class com.oracle.truffle.api.instrumentation.Tag

findProvidedTag, getIdentifier

Methods inherited from class java.lang.Object

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