Skip to main content

​
GetSteadyClockStartTimeNS

Valid for: CANoe DE • CANoe:lite DE • CANoe4SW DE • CANoe4SW:lite DE

​
Function Syntax

int64 GetSteadyClockStartTimeNS();

​
Description

Returns the measurement start time of a steady clock. This time is only useful in comparison with other times from that clock which you can get through GetSteadyClockCurrentTimeNS(). The steady clock provides a monotonic realtime. That time has no relation to a wallclock time and may drift slightly in comparison to the time stamps of measured frames, since the used clock in the computer is not synchronized to the one in the network interfaces (e.g. Vector VN devices). The time also has no relation to the simulation time, which is correlated to those time stamps, but which is constant during the processing of an event and which is explicitly set to the target time of simulation timers. The measurement start time is taken immediately before the on start handlers of the simulation nodes and similar functions are called. The function returns 0 if called in the on preStart handler.

​
Parameters

—

​
Return Values

Measurement start time of a steady clock in nanoseconds.

​
Example

Write("Since measurement start, %I64d nanoseconds have elapsed in realtime", 
      GetSteadyClockCurrentTimeNS() – GetSteadyClockStartTimeNS());
GetSteadyClockStartDurationNS • GetSteadyClockCurrentTimeNS • GetMeasurementStartTime