GrGen.NET v4.4 API: the libGr class library (the type exact interface gets generated)
ISubactionAndOutputAdditionEnvironment Interface
Namespacesde.unika.ipd.grGen.libGrISubactionAndOutputAdditionEnvironment
An environment extending basic action execution with subaction debugging, plus subgraph nesting, and output -- for one textual emits, and for the other graph change recording.
Declaration Syntax
C#
public interface ISubactionAndOutputAdditionEnvironment : IActionExecutionEnvironment
Members
All MembersMethodsPropertiesEvents



IconMemberDescription
Actions
The actions employed by this graph processing environment
(Inherited from IActionExecutionEnvironment.)
Custom(array<Object>[]()[][])
Does action execution environment dependent stuff.
(Inherited from IActionExecutionEnvironment.)
DebugEmitting(String, array<Object>[]()[][])
Fires an OnDebugEmit event.

DebugEntering(String, array<Object>[]()[][])
Fires an OnDebugEnter event.

DebugExiting(String, array<Object>[]()[][])
Fires an OnDebugExit event.

DebugHalting(String, array<Object>[]()[][])
Fires an OnDebugHalt event.

DebugHighlighting(String, List<(Of <<'(Object>)>>), List<(Of <<'(String>)>>))
Fires an OnDebugHighlight event.

EmitWriter
The writer used by emit statements. By default this is Console.Out.

Finished(IMatches, Boolean)
Fires an OnFinished event.
(Inherited from IActionExecutionEnvironment.)
Finishing(IMatches, Boolean)
Fires an OnFinishing event.
(Inherited from IActionExecutionEnvironment.)
GetNewestActionVersion(IAction)
Retrieves the newest version of an IAction object currently available for this graph. This may be the given object.
(Inherited from IActionExecutionEnvironment.)
Graph
Returns the graph currently focused in processing / sequence execution. This may be the initial main graph, or a subgraph switched to, the current top element of the graph usage stack.
(Inherited from IActionExecutionEnvironment.)
HighlightingUnderway
Tells whether execution is interrupted because a highlight statement was hit. Consequence: the timer that normally prints match statistics every second remains silent
(Inherited from IActionExecutionEnvironment.)
IsInSubgraph
Returns true when graph processings is currently occuring inside a subgraph, returns false when the main host graph is currently processed (i.e. only one entry on the current graph stack is existing).

Matched(IMatches, IMatch, Boolean)
Fires an OnMatched event.
(Inherited from IActionExecutionEnvironment.)
MaxMatches
The maximum number of matches to be returned for a RuleAll sequence element. If it is zero or less, the number of matches is unlimited.
(Inherited from IActionExecutionEnvironment.)
NamedGraph
Returns the named graph currently focused in processing / sequence execution. Returns null if this graph is not a named but an unnamed graph.
(Inherited from IActionExecutionEnvironment.)
OnDebugEmit
Fired when a debug emit is executed.

OnDebugEnter
Fired when a debug entity is entered.

OnDebugExit
Fired when a debug entity is left.

OnDebugHalt
Fired when a debug halt is executed.

OnDebugHighlight
Fired when a debug highlight is executed.

OnFinished
Fired after the rewrite step of a rule. Note, that the given matches object may contain invalid entries, as parts of the match may have been deleted!
(Inherited from IActionExecutionEnvironment.)
OnFinishing
Fired before the rewrite step of a rule, when at least one match has been found.
(Inherited from IActionExecutionEnvironment.)
OnMatched
Fired after all requested matches of a rule have been matched.
(Inherited from IActionExecutionEnvironment.)
OnReturnedFromSubgraph
Fired when graph processing is returning back after a switch. (To the main graph, or a subgraph previously switched to.)

OnRewritingNextMatch
Fired before the next match is rewritten. It is not fired before rewriting the first match.
(Inherited from IActionExecutionEnvironment.)
OnSwitchingToSubgraph
Fired when graph processing (rule and sequence execution) is switched to a (sub)graph. (Not fired when the main graph is replaced by another main graph, or initialized.)

PerformanceInfo
PerformanceInfo is used to accumulate information about needed time, found matches and applied rewrites. And additionally search steps carried out if profiling instrumentation code was generated. It must not be null. The user is responsible for resetting the PerformanceInfo object. This is typically done at the start of a rewrite sequence, to measure its performance.
(Inherited from IActionExecutionEnvironment.)
Recorder
The recorder of the main graph. Might be null (is set if a named graph is available, then the persistent names are taken from the named graph).

Replace(IMatches, Int32)
Executes the modifications of the according rule to the given match/matches. Fires OnRewritingNextMatch events before each rewrite except for the first one.
(Inherited from IActionExecutionEnvironment.)
ReturnFromSubgraph()()()()
Returns from the last switch to subgraph. (One level back on the current graph stack.)

RewritingNextMatch()()()()
Fires an OnRewritingNextMatch event.
(Inherited from IActionExecutionEnvironment.)
SetNewestActionVersion(IAction, IAction)
Sets the newest action version for a static action.
(Inherited from IActionExecutionEnvironment.)
SwitchToSubgraph(IGraph)
Switches the graph to the given (sub)graph. (One level added to the current graph stack.)

Assembly: libGr (Module: libGr) Version: 4.4.0.0 (4.4.0.0)