timerReportElapsedTime()
Purpose
Logs the elapsed time since a timer was started.
Syntax
timerReportElapsedTime( <timer_id>, <string> )
where:
<timer_id> is an integer timer identification number
<string> is a message to be logged with the elapsed time value
Description
The elapsed time of the timer identified as <timer_id> is logged and displayed in the test report with a <string> message.
The time unit is specified by the current Target Deployment Port. By default, the elapsed time is returned in milliseconds.
Timers must be started with timerReportElapsedTime() before an elapsed time can be calculated.
If an exception is thrown in a timerReportElapsedTime() method, an error is logged and the test continues.
Example
int timer1, timer2, timer3;
int any = 10;
timer1 = createTimer("first timer created");
timer2 = createTimer("second timer created");
timer3 = createTimer("third timer created");
//then start the timers.
timerStart(timer1,"Start 1");
timerStart(timer2,"Start 2");
timerStart(timer3,"Start 3");
//Report time.
long val1, val2, val3;
val2 = 100;
val3 = 1000;
val1 = 10000;
verifyLogMessage("Timer report");
timerReportElapsedTime(timer1,"report 1 ");
timerReportElapsedTime(timer2,"report 2 ");
timerReportElapsedTime(timer2,"report 2 ");
Related Topics