 | IActionExecutionEnvironment Interface |
An environment for the execution of actions (without embedded sequences).
Holds a reference to the current graph.
Namespace: de.unika.ipd.grGen.libGr
Assembly: libGr (in libGr.dll) Version: GrGen.NET 7.2
SyntaxC#
public interface IActionExecutionEnvironment
The IActionExecutionEnvironment type exposes the following members.
Properties| Name | Description | |
|---|---|---|
 | Actions |
The actions employed by this graph processing environment
|
| Backend |
The backend to be used for graph creation when a graph is imported
|
| CustomCommandsAndDescriptions |
The action execution environment dependent commands that are available, and a description of each command.
|
| EnableAssertions |
Allows to enable/disable assertions and find out about assertion state.
|
| 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.
|
| HighlightingUnderway |
Tells whether execution is interrupted because a highlight statement was hit.
Consequence: the timer that normally prints match statistics every second remains silent
|
| 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.
|
| NamedGraph |
Returns the named graph currently focused in processing / sequence execution.
Returns null if this graph is not a named but an unnamed graph.
|
| 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.
|
Methods| Name | Description | |
|---|---|---|
 | BeginExecution |
Fires an OnBeginExecution event.
|
| Custom |
Does action execution environment dependent stuff.
|
| EndExecution |
Fires an OnEndExecution event.
|
| Finished(IMatches, Boolean) |
Fires an OnFinished event.
|
| Finished(IMatches, Boolean) |
Fires an OnFinished event.
|
| FinishedSelectedMatch |
Fires an OnFinishedSelectedMatch event.
|
| GetNewestActionVersion |
Retrieves the newest version of an IAction object currently available for this graph.
This may be the given object.
|
| Match |
Matches a rewrite rule.
|
| MatchedAfterFiltering(IMatches, Boolean) |
Fires an OnMatchedAfter event.
|
| MatchedAfterFiltering(IMatches, Boolean) |
Fires an OnMatchedAfter event.
|
| MatchedBeforeFiltering(IMatches) |
Fires an OnMatchedBefore event.
|
| MatchedBeforeFiltering(IMatches) |
Fires an OnMatchedBefore event.
|
| 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).
|
| 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)).
|
| MatchSelected |
Fires an OnMatchSelected event.
|
| MatchWithoutEvent(Boolean, ActionCall) |
Matches the rewrite rules, without firing the Matched event, but fires the MatchedBeforeFiltering event (for internal or non-debugger use).
|
| 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).
|
| Replace |
Executes the modifications of the according rule to the given match/matches.
Fires OnRewritingNextMatch events before each rewrite except for the first one.
|
| RewritingSelectedMatch |
Fires an OnRewritingSelectedMatch event (comparable to the old OnFinishing and OnRewritingNextMatch, now one event, fired per selected match).
|
| SetNewestActionVersion |
Sets the newest action version for a static action.
|
Events| Name | Description | |
|---|---|---|
 | OnBeginExecution |
Fired when execution of a pattern matching construct begins.
|
| OnEndExecution |
Fired when execution of a pattern matching construct ends.
|
| 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!
|
| OnFinishedSelectedMatch |
Fired after the selected match was rewritten and embedded sequences executed.
|
| OnMatchedAfter |
Fired after all requested matches of a multi rule or rule have been matched (after filtering of matches).
|
| 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.
|
| OnMatchSelected |
Fired when a match was selected for execution (after filtering/selection of matches).
|
| OnRewritingSelectedMatch |
Fired before the selected match is rewritten (comparable to the old OnFinishing and OnRewritingNextMatch, now one event, fired per selected match).
|
| OnSelectedMatchRewritten |
Fired after the selected match was rewritten (but before embedded sequences are executed).
|
See Also