gadgets.h

Go to the documentation of this file.

/*
 * Copyright (C) 1996-2025 The Squid Software Foundation and contributors
 *
 * Squid software is distributed under GPLv2+ license and includes
 * contributions from numerous individuals and organizations.
 * Please see the COPYING and CONTRIBUTORS files for details.
 */
 
#ifndef SQUID_SRC_TIME_GADGETS_H
#define SQUID_SRC_TIME_GADGETS_H
 
#include <ctime>
#include <iosfwd>
 
/* Use uint64_t to store milliseconds */
typedef uint64_t time_msec_t;
 
extern double current_dtime;
 
extern time_t squid_curtime;
 
time_t getCurrentTime();
 
namespace Time {
 
time_t ParseIso3307(const char *);
 
const char *FormatRfc1123(time_t);
 
time_t ParseRfc1123(const char *);
 
const char *FormatStrf(time_t);
 
const char *FormatHttpd(time_t);
 
} // namespace Time
 
extern struct timeval current_time;
 
int tvSubUsec(struct timeval A, struct timeval B);
 
double tvSubDsec(struct timeval A, struct timeval B);
 
int tvSubMsec(struct timeval A, struct timeval B);
 
void tvSub(struct timeval &res, struct timeval const &t1, struct timeval const &t2);
 
void tvAdd(struct timeval &res, struct timeval const &t1, struct timeval const &t2);
 
void tvAssignAdd(struct timeval &t, struct timeval const &add);
 
inline long int tvToMsec(struct timeval &t)
{
    return t.tv_sec * 1000 + t.tv_usec / 1000;
}
 
std::ostream &operator <<(std::ostream &, const timeval &);
 
// TODO: Remove direct timercmp() calls in legacy code.
 
inline bool
operator <(const timeval &a, const timeval &b)
{
    return timercmp(&a, &b, <);
}
 
inline bool
operator >(const timeval &a, const timeval &b)
{
    return timercmp(&a, &b, >);
}
 
inline bool
operator !=(const timeval &a, const timeval &b)
{
    return timercmp(&a, &b, !=);
}
 
// Operators for timeval below avoid timercmp() because Linux timeradd(3) manual
// page says that their timercmp() versions "do not work" on some platforms.
 
inline bool
operator <=(const timeval &a, const timeval &b)
{
    return !(a > b);
}
 
inline bool
operator >=(const timeval &a, const timeval &b)
{
    return !(a < b);
}
 
inline bool
operator ==(const timeval &a, const timeval &b)
{
    return !(a != b);
}
 
#endif /* SQUID_SRC_TIME_GADGETS_H */