RWClockTimer Struct Reference

Measures elapsed wall clock time. More...

#include <rw/timer.h>

Public Member Functions
	RWClockTimer ()
rwint64	elapsedMicroseconds () const
rwint64	elapsedMilliseconds () const
rwint64	elapsedSeconds () const
double	elapsedTime () const
void	reset ()
void	start ()
void	stop ()

Detailed Description

This class measures elapsed wall clock time. The timer has two states: running and stopped. The timer measures the total amount of time spent in the "running" state since it was either constructed or reset.

The timer is put into the "running" state by calling member function start(). It is put into the "stopped" state by calling stop().

Synopsis

#include <rw/timer.h>
RWClockTimer timer;

Persistence

None

Example

#include <iostream>

#include <rw/timer.h>
#include <rw/tools/datetime.h>

int main()
{
    std::cout << "Starting the timer ...\n";
    std::cout << "... and looping for 5 seconds using RWDateTime as clock ...\n";

    RWClockTimer t;
    t.start(); // Start the timer

    // Loop for 5 seconds:

    RWDateTime tmp (RWDateTime::setCurrentTime);
    for (; (RWDateTime::now () - tmp) < 5000;) { }

    t.stop(); // Stop the timer

    std::cout << "The elapsed time was: \n";

    std::cout << "Wall    : "
              << double (t.elapsedMicroseconds()) /  1000000.0F
              << " seconds.\n";

    return 0;
}

Constructor & Destructor Documentation

RWClockTimer::RWClockTimer

(

)

Constructs a new timer. The timer does not start running until start() is called.

Member Function Documentation

rwint64 RWClockTimer::elapsedMicroseconds

(

)

const

Returns the number of microseconds that have elapsed while the timer was in the running state.

rwint64 RWClockTimer::elapsedMilliseconds

(

)

const

Returns the number of milliseconds that have elapsed while the timer was in the running state.

rwint64 RWClockTimer::elapsedSeconds

(

)

const

Returns the number of seconds that have elapsed while the timer was in the running state.

double RWClockTimer::elapsedTime

(

)

const

Returns the amount of time in seconds that has accumulated while the timer was in the running state.

void RWClockTimer::reset

(

)

Resets (and stops) the timer.

void RWClockTimer::start

(

)

Puts the timer in the "running" state. Time accumulates while in this state.

void RWClockTimer::stop

(

)

Puts the timer in the "stopped" state. Time does not accumulate while in this state.