#include <TimeVal.h>

Inheritance diagram for ASSA::TimeVal:

Public Types
enum	{ gmt, loc }

Public Member Functions
	TimeVal ()
	Default constructor. More...

	TimeVal (long sec_, long msec_)
	Constructor from seconds/microseconds pair. More...

	TimeVal (double d_)
	Constructor from double. More...

	TimeVal (const timeval &tv_)
	Constructor from `struct timeval`. More...

	TimeVal (const TimeVal &tv_)
	Copy constructor. More...

	operator double () const
	Implicit conversion to double. More...

void	sec (long sec_)
	Set seconds. More...

long	sec (void) const
	Get secons. More...

void	msec (long msec_)
	Set microseconds. More...

long	msec (void) const
	Get microseconds. More...

long	millisec () const
	Convert tv_usec's microseconds (=1/1,000,000 sec) to milliseconds (=1/1,000 sec). More...

void	tz (int tz_)
	Set timezone. More...

int	tz (void) const
	Get timezone. More...

TimeVal &	operator= (const TimeVal &tv_)

TimeVal &	operator+= (const TimeVal &rhs_)
	Addition. More...

TimeVal &	operator-= (const TimeVal &rhs_)
	Substraction. More...

bool	operator< (const TimeVal &rhs_) const
	Comparison. More...

bool	operator== (const TimeVal &rhs_) const
	Equality. More...

string	fmtString (const char *fmt_=NULL) const
	Format timeval structure into readable format. More...

string	fmt_hh_mm_ss () const
	Format timeval structure in readable format HH:MM:SS. More...

string	fmt_hh_mm_ss_mls () const
	Format timeval structure in readable format HH:MM:SS.MLS. More...

string	fmt_mm_ss () const
	Format timeval structure in readable format MM:SS. More...

string	fmt_mm_ss_mls () const
	Format timeval structure in readable format MM:SS.MLS. More...

string	fmt_ss_mls () const
	Format timeval structure in readable format SS.MLS. More...

void	dump_to_log (const string &name_="") const
	Dump value of struct timeval to the log file with mask TRACE = DBG_APP15. More...

Static Public Member Functions
static TimeVal	zeroTime ()
	Static that returns zero timeval: {0,0}. More...

static TimeVal	gettimeofday ()
	Shields off underlying OS differences in getting current time. More...

Protected Member Functions
void	init (long, long, int)
	Internal initialization common to most constructors. More...

Private Member Functions
void	normalize ()
	Normalization after arithmetic operation. More...

Private Attributes
int	m_tz
	Time zone. More...

Static Private Attributes
static TimeVal	m_zero
	Zero time value. More...

Friends
TimeVal	operator+ (const TimeVal &lhs_, const TimeVal &rhs_)
	Addition. More...

TimeVal	operator- (const TimeVal &lhs_, const TimeVal &rhs_)
	Substraction. More...

bool	operator> (const TimeVal &lhs_, const TimeVal &rhs_)
	Comparison. More...

bool	operator!= (const TimeVal &lhs_, const TimeVal &rhs_)
	Comparison. More...

bool	operator<= (const TimeVal &lhs_, const TimeVal &rhs_)
	Comparison. More...

bool	operator>= (const TimeVal &lhs_, const TimeVal &rhs_)
	Comparison. More...

Detailed Description

Definition at line 30 of file TimeVal.h.

Member Enumeration Documentation

anonymous enum

Enumerator
gmt	GMT.
loc	Local Time Zone.

Definition at line 33 of file TimeVal.h.

Constructor & Destructor Documentation

ASSA::TimeVal::TimeVal ( )

inline

Default constructor.

Sets time to 0 sec. 0 usecs. To get current time, use TimeVal (gettimeofday());

Definition at line 196 of file TimeVal.h.

References gmt, and init().

 {
     init (0, 0, gmt);
 }

ASSA::TimeVal::TimeVal	(	long	sec_,
		long	msec_
	)

inline

Constructor from seconds/microseconds pair.

Definition at line 203 of file TimeVal.h.

References gmt, and init().

 {
     init (sec_, msec_, gmt);
 }

ASSA::TimeVal::TimeVal ( double d_ )

inline

Constructor from double.

Definition at line 210 of file TimeVal.h.

References normalize().

     : m_tz (gmt)
 {
     long l = long(d_);
     tv_sec = l;
     tv_usec = (long) ((d_ - double(l))*1000000.0);
     normalize();
 }

ASSA::TimeVal::TimeVal ( const timeval & tv_ )

inline

Constructor from struct timeval.

Definition at line 221 of file TimeVal.h.

References gmt, and init().

 {
     init (tv_.tv_sec, tv_.tv_usec, gmt);
 }

ASSA::TimeVal::TimeVal ( const TimeVal & tv_ )

inline

Copy constructor.

Definition at line 228 of file TimeVal.h.

References init(), and m_tz.

 {
     init (tv_.tv_sec, tv_.tv_usec, tv_.m_tz);
 }

Member Function Documentation

void TimeVal::dump_to_log ( const string & name_ = "" ) const

Dump value of struct timeval to the log file with mask TRACE = DBG_APP15.

Definition at line 227 of file TimeVal.cpp.

References DL, fmt_mm_ss_mls(), ASSA::Singleton< Logger >::get_instance(), millisec(), msec(), ASSA::REACT, sec(), and trace.

 {
     static const char self []="TimeVal::dump_to_log"; trace(self);
 
     if (Logger::get_instance ()->group_enabled (REACT)) 
     {
         DL((REACT,"=== TimeVal %s ===\n", var_name_.c_str ()));
         DL((REACT,"MM:SS:MLS = %s\n", fmt_mm_ss_mls ().c_str ()));
         DL((REACT,"tv_sec = %d, tv_msec = %d, tv_mls = %d\n",
             sec (), msec (), millisec ()));
         DL((REACT,"(double)  = %7.4f\n", double (*this)));
         DL((REACT,"==================\n"));
     }
 }

string ASSA::TimeVal::fmt_hh_mm_ss ( ) const

inline

Format timeval structure in readable format HH:MM:SS.

Definition at line 248 of file TimeVal.h.

References fmtString().

 {
     return fmtString ("%T");
 }

string TimeVal::fmt_hh_mm_ss_mls ( ) const

Format timeval structure in readable format HH:MM:SS.MLS.

Definition at line 170 of file TimeVal.cpp.

References gmt, m_tz, and millisec().

 {
     struct tm ct;
     char buf [80];
     memset (buf, 0, 80);
 
     if (m_tz == gmt)
         ct = *( localtime ((const time_t*) &tv_sec) );
     else
         ct = *( gmtime ((const time_t*) &tv_sec) );
 
     strftime (buf, 80, "%H:%M:%S", &ct);
     sprintf (buf + strlen(buf), ".%03ld", millisec ());
 
     return string (buf);
 }

string ASSA::TimeVal::fmt_mm_ss ( ) const

inline

Format timeval structure in readable format MM:SS.

Definition at line 255 of file TimeVal.h.

References fmtString().

 {
     return fmtString ("%M:%S");
 }

string TimeVal::fmt_mm_ss_mls ( ) const

Format timeval structure in readable format MM:SS.MLS.

Definition at line 189 of file TimeVal.cpp.

References gmt, m_tz, and millisec().

Referenced by ASSA::Timer::dump(), and dump_to_log().

 {
     struct tm ct;
     char buf [80];
     memset (buf, 0, 80);
 
     if (m_tz == gmt)
         ct = *( localtime ((const time_t*) &tv_sec) );
     else
         ct = *( gmtime ((const time_t*) &tv_sec) );
 
     strftime (buf, 80, "%M:%S", &ct);
     sprintf (buf + strlen(buf), ".%03ld", millisec ());
 
     return string (buf);
 }

string TimeVal::fmt_ss_mls ( ) const

Format timeval structure in readable format SS.MLS.

Definition at line 208 of file TimeVal.cpp.

References gmt, m_tz, and millisec().

 {
     struct tm ct;
     char buf [80];
     memset (buf, 0, 80);
 
     if (m_tz == gmt)
         ct = *( localtime ((const time_t*) &tv_sec) );
     else
         ct = *( gmtime ((const time_t*) &tv_sec) );
 
     strftime (buf, 80, "%S", &ct);
     sprintf (buf + strlen(buf), ".%03ld", millisec ());
 
     return string (buf);
 }

string TimeVal::fmtString ( const char * fmt_ = NULL ) const

Format timeval structure into readable format.

Default format is CCYY/DDD HH:MM:SS.MMM which is de fasco for the software. To get something different, pass fmt_ format string as specified by strftime(3). Popular format is "%c" which will return something like: "Fri Oct 1 10:54:27 1999". Note that timezone aspect of formatting time is controlled by tz() member function.

Parameters

fmt_	Format string as in strftime(3)

Returns: Formatted string.

Definition at line 146 of file TimeVal.cpp.

References gmt, and m_tz.

Referenced by ASSA::Logger_Impl::add_timestamp(), ASSA::Timer::dump(), ASSA::TimerQueue::expire(), fmt_hh_mm_ss(), fmt_mm_ss(), and ASSA::Reactor::registerTimerHandler().

 {
     struct tm ct;
     char buf[80];
     memset (buf, 0, 80);
 
     if (m_tz == gmt)
         ct = *( localtime ((const time_t*) &tv_sec) );
     else
         ct = *( gmtime ((const time_t*) &tv_sec) );
 
     if (fmt_ == NULL) {
         strftime (buf, 80, "%Y/%j %H:%M:%S", &ct);
         sprintf (buf + strlen(buf),
              ".%03ld", (tv_usec %1000000)/1000);
     }
     else {
         strftime(buf, 80, fmt_, &ct);
     }
     return string (buf);
 }

TimeVal TimeVal::gettimeofday ( )

static

Shields off underlying OS differences in getting current time.

Returns: time of the day as timeval

Definition at line 44 of file TimeVal.cpp.

References EPOCHFILETIME.

Referenced by ASSA::Logger_Impl::add_timestamp(), ASSA::Reactor::calculateTimeout(), ASSA::Reactor::dispatch(), ASSA::Reactor::registerTimerHandler(), ASSA::Timer::rescheduleExpirationTime(), ASSA::Reactor::waitForEvents(), and ASSA::TimerCountdown::~TimerCountdown().

 { 
     timeval tv;
     
 #ifdef WIN32
     FILETIME        ft;
     LARGE_INTEGER   li;
     __int64         t;
     static int      tzflag;
 
     GetSystemTimeAsFileTime(&ft);
     li.LowPart  = ft.dwLowDateTime;
     li.HighPart = ft.dwHighDateTime;
     t  = li.QuadPart;       /* In 100-nanosecond intervals */
     t -= EPOCHFILETIME;     /* Offset to the Epoch time */
     t /= 10;                /* In microseconds */
     tv.tv_sec  = (long)(t / 1000000);
     tv.tv_usec = (long)(t % 1000000); 
 #else
     ::gettimeofday (&tv, 0);
 #endif
     return tv;
 }

void ASSA::TimeVal::init	(	long	s_,
		long	ms_,
		int	tz_
	)

inlineprotected

Internal initialization common to most constructors.

Definition at line 186 of file TimeVal.h.

References m_tz, and normalize().

Referenced by operator=(), and TimeVal().

 {
     tv_sec = s_;
     tv_usec = ms_;
     m_tz = tz_;
     normalize ();
 }

long ASSA::TimeVal::millisec ( ) const

inline

Convert tv_usec's microseconds (=1/1,000,000 sec) to milliseconds (=1/1,000 sec).

Definition at line 241 of file TimeVal.h.

References msec().

Referenced by dump_to_log(), fmt_hh_mm_ss_mls(), fmt_mm_ss_mls(), and fmt_ss_mls().

 {
     return (msec () % 1000000) / 1000;
 }

void ASSA::TimeVal::msec ( long msec_ )

inline

Set microseconds.

Definition at line 70 of file TimeVal.h.

Referenced by ASSA::Logger_Impl::add_timestamp(), and ASSA::Reactor::registerTimerHandler().

70 { tv_usec = msec_; }

long ASSA::TimeVal::msec ( void ) const

inline

Get microseconds.

Definition at line 73 of file TimeVal.h.

Referenced by dump_to_log(), and millisec().

73 { return tv_usec; }

void TimeVal::normalize ( )

private

Normalization after arithmetic operation.

Definition at line 112 of file TimeVal.cpp.

References ONE_SECOND.

Referenced by init(), ASSA::operator+(), operator+=(), ASSA::operator-(), operator-=(), and TimeVal().

 {
     if (tv_usec >= ONE_SECOND) {
         do {
             tv_sec++;
             tv_usec -= ONE_SECOND;
         }
         while (tv_usec >= ONE_SECOND);
     }
     else if (tv_usec <= -ONE_SECOND) {
         do {
             tv_sec--;
             tv_usec += ONE_SECOND;
         }
         while (tv_usec <= -ONE_SECOND);
     }
 
     if (tv_sec >= 1 && tv_usec < 0) {
         tv_sec--;
         tv_usec += ONE_SECOND;
     }
     else if (tv_sec < 0 && tv_usec > 0) {
         tv_sec++;
         tv_usec -= ONE_SECOND;
     }
 }

ASSA::TimeVal::operator double ( ) const

inline

Implicit conversion to double.

Definition at line 234 of file TimeVal.h.

 { 
     return tv_sec + tv_usec / 1000000.0;
 }

TimeVal & TimeVal::operator+= ( const TimeVal & rhs_ )

Addition.

Definition at line 74 of file TimeVal.cpp.

References normalize(), and ONE_SECOND.

 {
     tv_sec += rhs_.tv_sec;
     tv_usec += rhs_.tv_usec;
 
     if (tv_usec >= ONE_SECOND) {
         tv_usec -= ONE_SECOND;
         tv_sec++;
     } 
     else if (tv_sec >= 1 && tv_usec < 0) {
         tv_usec += ONE_SECOND;
         tv_sec--;
     }
     normalize ();
     return *this;
 }

TimeVal & TimeVal::operator-= ( const TimeVal & rhs_ )

Substraction.

Definition at line 93 of file TimeVal.cpp.

References normalize(), and ONE_SECOND.

 {
     tv_sec -= rhs_.tv_sec;
     tv_usec -= rhs_.tv_usec;
 
     if (tv_usec < 0) {
         tv_usec += ONE_SECOND;
         tv_sec--;
     } 
     else if (tv_usec >= ONE_SECOND) {
         tv_usec -= ONE_SECOND;
         tv_sec++;
     }
     normalize ();
     return *this;
 }

bool ASSA::TimeVal::operator< ( const TimeVal & rhs_ ) const

inline

Comparison.

Definition at line 292 of file TimeVal.h.

 {
     return (tv_sec < rhs_.tv_sec
         || (tv_sec == rhs_.tv_sec && tv_usec < rhs_.tv_usec) ) ;
 }

TimeVal & ASSA::TimeVal::operator= ( const TimeVal & tv_ )

inline

Definition at line 266 of file TimeVal.h.

References init(), and m_tz.

 {
     init (tv_.tv_sec, tv_.tv_usec, tv_.m_tz);
     return *this;
 }

bool ASSA::TimeVal::operator== ( const TimeVal & rhs_ ) const

inline

Equality.

Definition at line 300 of file TimeVal.h.

 {
     return !(*this < rhs_ || rhs_ < *this);
 }

void ASSA::TimeVal::sec ( long sec_ )

inline

Set seconds.

Definition at line 64 of file TimeVal.h.

Referenced by ASSA::Reactor::registerTimerHandler().

64 { tv_sec = sec_; }

long ASSA::TimeVal::sec ( void ) const

inline

Get secons.

Definition at line 67 of file TimeVal.h.

Referenced by dump_to_log().

67 { return tv_sec; }

void ASSA::TimeVal::tz ( int tz_ )

inline

Set timezone.

Definition at line 81 of file TimeVal.h.

References m_tz.

Referenced by ASSA::Logger_Impl::add_timestamp().

81 { m_tz = tz_; }

ASSA::TimeVal::m_tz

int m_tz

Time zone.

Definition: TimeVal.h:175

int ASSA::TimeVal::tz ( void ) const

inline

Get timezone.

Definition at line 84 of file TimeVal.h.

References m_tz.

84 { return m_tz; }

ASSA::TimeVal::m_tz

int m_tz

Time zone.

Definition: TimeVal.h:175

static TimeVal ASSA::TimeVal::zeroTime ( )

inlinestatic

Static that returns zero timeval: {0,0}.

Definition at line 157 of file TimeVal.h.

References m_zero.

Referenced by ASSA::Reactor::calculateTimeout(), and ASSA::TimerCountdown::~TimerCountdown().

157 { return m_zero; }

ASSA::TimeVal::m_zero

static TimeVal m_zero

Zero time value.

Definition: TimeVal.h:178

Friends And Related Function Documentation

bool operator!=	(	const TimeVal &	lhs_,
		const TimeVal &	rhs_
	)

friend

Comparison.

Definition at line 312 of file TimeVal.h.

 {
     return !( lhs_ == rhs_ );
 }

TimeVal operator+	(	const TimeVal &	lhs_,
		const TimeVal &	rhs_
	)

friend

Addition.

Definition at line 273 of file TimeVal.h.

 {
     TimeVal temp(lhs_);
     temp += rhs_;
     temp.normalize ();
     return temp;
 }

TimeVal operator-	(	const TimeVal &	lhs_,
		const TimeVal &	rhs_
	)

friend

Substraction.

Definition at line 282 of file TimeVal.h.

 {
     TimeVal temp(lhs_);
     temp -= rhs_;
     temp.normalize ();
     return temp;
 }

bool operator<=	(	const TimeVal &	lhs_,
		const TimeVal &	rhs_
	)

friend

Comparison.

Definition at line 318 of file TimeVal.h.

 {
     return !(rhs_ < lhs_);
 }

bool operator>	(	const TimeVal &	lhs_,
		const TimeVal &	rhs_
	)

friend

Comparison.

Definition at line 306 of file TimeVal.h.

 {
     return rhs_ < lhs_;
 }

bool operator>=	(	const TimeVal &	lhs_,
		const TimeVal &	rhs_
	)

friend

Comparison.

Definition at line 324 of file TimeVal.h.

 {
     return !(lhs_ < rhs_);
 }

Member Data Documentation

int ASSA::TimeVal::m_tz

private

Time zone.

Definition at line 175 of file TimeVal.h.

Referenced by fmt_hh_mm_ss_mls(), fmt_mm_ss_mls(), fmt_ss_mls(), fmtString(), init(), operator=(), TimeVal(), and tz().

TimeVal TimeVal::m_zero

staticprivate

Zero time value.

Definition at line 178 of file TimeVal.h.

Referenced by zeroTime().

The documentation for this class was generated from the following files:

/tmp/buildd/libassa-3.5.1/assa/TimeVal.h
/tmp/buildd/libassa-3.5.1/assa/TimeVal.cpp

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Friends

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation