Syntax 3 For trace files
Description
Goes back to the beginning of the trace file so you can begin
rereading the file contents.
Controls
TraceFile objects
Syntax
|
1 |
<span><span>instancename</span>.Reset</span> ( ) |
|
Argument |
Description |
|---|---|
|
instancename |
Instance name of the TraceFile object |
Return Values
ErrorReturn. Returns one of the following values:
-
Success! – The function
succeeded -
FileNotOpenError! – The specified trace
file has not been opened
Usage
Use this function to return to the start of the open trace
file and begin rereading the contents of the file. To use the Reset function,
you must have previously opened the trace file with the Open function.
You use the Reset and Open functions
as well as the other properties and functions provided by the TraceFile
object to access the contents of a trace file directly. You use
these functions if you want to perform your own analysis of the
tracing data instead of using the available modeling objects.
Examples
This example returns execution to the start of the
open trace file ltf_file so that the
file’s contents can be reread:
|
1 |
TraceFile ltf_file |
|
1 |
string ls_filename |
|
1 |
|
1 |
ltf_file = CREATE TraceFile |
|
1 |
ltf_file.Open(ls_filename) |
|
1 |
... |
|
1 |
ltf_file.<span>Reset</span>(ls_filename) |
|
1 |
... |