GetChildrenList
PowerScript function
Description
Provides a list of the children of a routine included in a trace
tree model.
Applies to
TraceTreeObject, TraceTreeRoutine, and TraceTreeGarbageCollect
objects
Syntax
|
1 |
instancename.GetChildrenList ( list ) |
|
Argument |
Description |
|---|---|
|
instancename |
Instance name of the TraceTreeObject, TraceTreeRoutine, or |
|
list |
An unbounded array variable of datatype TraceTreeNode in |
Return value
ErrorReturn. Returns the following values:
-
Success! — The function succeeded
-
ModelNotExistsError! — The model does not exist
Usage
You use the GetChildrenList function to extract a list of the
children of a routine (the classes and routines it calls) included in a
trace tree model. Each child listed is defined as a TraceTreeNode object
and provides the type of activity represented by that child.
You must have previously created the trace tree model from a trace
file using the BuildModel function.
When the GetChildrenList function is called for
TraceTreeGarbageCollect objects, each child listed usually represents the
destruction of a garbage collected object.
Examples
This example checks the activity type of a node included in the
trace tree model. If the activity type is an occurrence of a routine, it
determines the name of the class that contains the routine and provides a
list of the classes and routines called by that routine:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
TraceTree ltct_node TraceTreeNode ltctn_list ... CHOOSE CASE node.ActivityType CASE ActRoutine! TraceTreeRoutine ltctrt_rout ltctrt_rout = ltct_node result += "Enter " + ltctrt_rout.ClassName & + "." + ltctrt_rout.name + " " & + String(ltctrt_rout.ObjectID) + " " & + String(ltctrt_rout.EnterTimerValue) & + "~r~n" ltctrt_rout.GetChildrenList(ltctn_list) ... |
See also