com.oracle.truffle.api.instrumentation

Class SourceFilter

java.lang.Object

com.oracle.truffle.api.instrumentation.SourceFilter

public final class SourceFilter
extends Object

A source filter represents an expression for a subset of guest language sources that are used in an Truffle interpreter.

Start building event filters by calling SourceFilter.newBuilder() and complete them by calling SourceFilter.Builder.build().

Since:

0.32

See Also:

SourceFilter.newBuilder(), Instrumenter.attachLoadSourceListener(SourceFilter, LoadSourceListener, boolean)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	SourceFilter.Builder Configure your own SourceFilter before creating its instance.

Field Summary

Fields

Modifier and Type	Field and Description
static SourceFilter	ANY A filter that matches any source.

Method Summary

Modifier and Type	Method and Description
static SourceFilter.Builder	newBuilder() Creates a new SourceFilter expression using a builder pattern.

Methods inherited from class java.lang.Object

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

Field Detail

ANY

public static final SourceFilter ANY

A filter that matches any source.

Since:

0.32

Method Detail

newBuilder

public static SourceFilter.Builder newBuilder()

Creates a new SourceFilter expression using a builder pattern. Individual builder statements are interpreted as conjunctions (AND) while multiple parameters for individual filter expressions are treated as disjunctions (OR). To create the final filter finalize the expression using SourceFilter.Builder.build().

Returns:

a new builder to create new SourceFilter instances

Since:

0.32

See Also:

SourceFilter.Builder.sourceIs(Source...), SourceFilter.Builder.sourceIs(Predicate), SourceFilter.Builder.languageIs(String...), SourceFilter.Builder.includeInternal(boolean), SourceFilter.Builder.build()