 | ISubaction |
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.
Namespace: de.unika.ipd.grGen.libGr
Assembly: libGr (in libGr.dll) Version: GrGen.NET 7.1
SyntaxC#
public interface ISubactionAndOutputAdditionEnvironment : IActionExecutionEnvironment
The ISubactionAndOutputAdditionEnvironment type exposes the following members.
Properties| Name | Description | |
|---|---|---|
 | Actions |
The actions employed by this graph processing environment
(Inherited from IActionExecutionEnvironment) |
| Backend |
The backend to be used for graph creation when a graph is imported
(Inherited from IActionExecutionEnvironment) |
| CustomCommandsAndDescriptions |
The action execution environment dependent commands that are available, and a description of each command.
(Inherited from IActionExecutionEnvironment) |
| EmitWriter | The writer used by emit statements. By default this is ConsoleUI.outWriter (normally forwarded to Console.Out). |
| EmitWriterDebug | The writer used by emitdebug statements. This is ConsoleUI.outWriter (normally forwarded to Console.Out), and can't be redirected to a file in contrast to the EmitWriter. |
| EnableAssertions |
Allows to enable/disable assertions and find out about assertion state.
(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). |
| 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) |
| 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). |
Methods| Name | Description | |
|---|---|---|
 | BeginExecution |
Fires an OnBeginExecution event.
(Inherited from IActionExecutionEnvironment) |
| Custom |
Does action execution environment dependent stuff.
(Inherited from IActionExecutionEnvironment) |
| DebugEmitting | Fires an OnDebugEmit event. |
| DebugEntering | Fires an OnDebugEnter event. |
| DebugExiting | Fires an OnDebugExit event. |
| DebugHalting | Fires an OnDebugHalt event. |
| DebugHighlighting | Fires an OnDebugHighlight event. |
| EndExecution |
Fires an OnEndExecution event.
(Inherited from IActionExecutionEnvironment) |
| Finished(IMatches, Boolean) |
Fires an OnFinished event.
(Inherited from IActionExecutionEnvironment) |
| Finished(IMatches, Boolean) |
Fires an OnFinished event.
(Inherited from IActionExecutionEnvironment) |
| FinishedSelectedMatch |
Fires an OnFinishedSelectedMatch event.
(Inherited from IActionExecutionEnvironment) |
| GetNewestActionVersion |
Retrieves the newest version of an IAction object currently available for this graph.
This may be the given object.
(Inherited from IActionExecutionEnvironment) |
| Match |
Matches a rewrite rule.
(Inherited from IActionExecutionEnvironment) |
| MatchedAfterFiltering(IMatches, Boolean) |
Fires an OnMatchedAfter event.
(Inherited from IActionExecutionEnvironment) |
| MatchedAfterFiltering(IMatches, Boolean) |
Fires an OnMatchedAfter event.
(Inherited from IActionExecutionEnvironment) |
| MatchedBeforeFiltering(IMatches) |
Fires an OnMatchedBefore event.
(Inherited from IActionExecutionEnvironment) |
| MatchedBeforeFiltering(IMatches) |
Fires an OnMatchedBefore event.
(Inherited from IActionExecutionEnvironment) |
| MatchForQuery(Boolean, ActionCall) |
Matches the rewrite rules, without firing the Matched event, but with firing the PreMatch event and Cloning of the matches
(so they can stored, or used in an expression combining multiple queries).
(Inherited from IActionExecutionEnvironment) |
| MatchForQuery(IAction, Object, Int32, Boolean) |
Matches a rewrite rule, without firing the Matched event, but with firing the PreMatch event and Cloning of the matches
(so they can stored, or used in an expression combining multiple queries like [?r] + [?r],
or the action can be called multiple times in a multi rule all call query (on different parameters)).
(Inherited from IActionExecutionEnvironment) |
| MatchSelected |
Fires an OnMatchSelected event.
(Inherited from IActionExecutionEnvironment) |
| MatchWithoutEvent(Boolean, ActionCall) |
Matches the rewrite rules, without firing the Matched event, but fires the MatchedBeforeFiltering event (for internal or non-debugger use).
(Inherited from IActionExecutionEnvironment) |
| MatchWithoutEvent(IAction, Object, Int32, Boolean) |
Matches a rewrite rule, without firing the Matched event (but fires the MatchedBeforeFiltering event - for internal or non-debugger use).
(Inherited from IActionExecutionEnvironment) |
| Replace |
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.) |
| RewritingSelectedMatch |
Fires an OnRewritingSelectedMatch event (comparable to the old OnFinishing and OnRewritingNextMatch, now one event, fired per selected match).
(Inherited from IActionExecutionEnvironment) |
| SetNewestActionVersion |
Sets the newest action version for a static action.
(Inherited from IActionExecutionEnvironment) |
| SwitchToSubgraph | Switches the graph to the given (sub)graph. (One level added to the current graph stack.) |
Events| Name | Description | |
|---|---|---|
 | OnBeginExecution |
Fired when execution of a pattern matching construct begins.
(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. |
| OnEndExecution |
Fired when execution of a pattern matching construct ends.
(Inherited from IActionExecutionEnvironment) |
| OnFinished |
Fired after the rewrite step of a rule/after rule execution has completed.
Note, that the given matches object may contain invalid entries,
as parts of the match may have been deleted!
(Inherited from IActionExecutionEnvironment) |
| OnFinishedSelectedMatch |
Fired after the selected match was rewritten and embedded sequences executed.
(Inherited from IActionExecutionEnvironment) |
| OnMatchedAfter |
Fired after all requested matches of a multi rule or rule have been matched (after filtering of matches).
(Inherited from IActionExecutionEnvironment) |
| OnMatchedBefore |
Fired after all requested matches of a multi rule or rule have been matched, before filtering of the matches.
Allows a lookahead on the matches, on all found matches, in contrast to OnMatchedAfter that only reports the ones that are applied in the end.
(Inherited from IActionExecutionEnvironment) |
| OnMatchSelected |
Fired when a match was selected for execution (after filtering/selection of matches).
(Inherited from IActionExecutionEnvironment) |
| OnReturnedFromSubgraph | Fired when graph processing is returning back after a switch. (To the main graph, or a subgraph previously switched to.) |
| OnRewritingSelectedMatch |
Fired before the selected match is rewritten (comparable to the old OnFinishing and OnRewritingNextMatch, now one event, fired per selected match).
(Inherited from IActionExecutionEnvironment) |
| OnSelectedMatchRewritten |
Fired after the selected match was rewritten (but before embedded sequences are executed).
(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.) |
See Also