\( \newcommand{\E}{\mathrm{E}} \) \( \newcommand{\A}{\mathrm{A}} \) \( \newcommand{\R}{\mathrm{R}} \) \( \newcommand{\N}{\mathrm{N}} \) \( \newcommand{\Q}{\mathrm{Q}} \) \( \newcommand{\Z}{\mathrm{Z}} \) \( \def\ccSum #1#2#3{ \sum_{#1}^{#2}{#3} } \def\ccProd #1#2#3{ \sum_{#1}^{#2}{#3} }\)
CGAL 4.12 - Profiling tools, Hash Map, Union-find, Modifiers

#include <CGAL/Real_timer.h>

Definition

The class Real_timer is a timer class for measuring real time.

A timer t of type Real_timer is an object with a state. It is either running or it is stopped. The state is controlled with Real_timer::start() and Real_timer::stop(). The timer counts the time elapsed since its creation or last reset. It counts only the time where it is in the running state. The time information is given in seconds. The timer counts also the number of intervals it was running, i.e. it counts the number of calls of the Real_timer::start() member function since the last reset. If the reset occures while the timer is running it counts as the first interval.

Implementation

The timer class is based on the C function gettimeofday() on POSIX systems and the C function _ftime() on MS Visual C++. The system calls to these timers might fail, in which case a warning message will be issued through the CGAL error handler and the functions return with the error codes indicated above. The Real_timer::precision() method computes the precision dynamically at runtime at its first invocation.

Creation

 Real_timer ()
 state is stopped.
 

Operations

void start ()
 
void stop ()
 
void reset ()
 reset timer to zero. More...
 
bool is_running () const
 true if the current state is running.
 
double time () const
 real time in seconds, or 0 if the underlying system call failed.
 
int intervals () const
 number of start/stop-intervals since the last reset.
 
double precision () const
 smallest possible time step in seconds, or -1 if the system call failed.
 
double max const ()
 maximal representable time in seconds.
 

Member Function Documentation

◆ reset()

void CGAL::Real_timer::reset ( )

reset timer to zero.

The state is unaffected.

◆ start()

void CGAL::Real_timer::start ( )
Precondition
state is stopped.

◆ stop()

void CGAL::Real_timer::stop ( )
Precondition
state is running.