/*
- Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
- Copyright (C) 2000-2007 Paul Davis
+ Copyright (C) 2012-2021 Carl Hetherington <cth@carlh.net>
+
This file is part of DCP-o-matic.
DCP-o-matic is free software; you can redistribute it and/or modify
*/
+
/** @file src/timer.h
* @brief Some timing classes for debugging and profiling.
*/
+
#ifndef DCPOMATIC_TIMER_H
#define DCPOMATIC_TIMER_H
+
#include <sys/time.h>
+#include <boost/optional.hpp>
#include <string>
#include <map>
+
/** @class PeriodTimer
* @brief A class to allow timing of a period within the caller.
*
struct timeval _start;
};
+
/** @class StateTimer
* @brief A class to allow measurement of the amount of time a program
* spends in one of a set of states.
class StateTimer
{
public:
+ explicit StateTimer (std::string n);
+ /** @param n Name to use when giving output.
+ * @param s Initial state.
+ */
StateTimer (std::string n, std::string s);
~StateTimer ();
- void set_state (std::string s);
+ /** @param s New state that the caller is in */
+ void set (std::string s);
+ void unset ();
+
+ std::string name () const {
+ return _name;
+ }
+
+ class Counts
+ {
+ public:
+ double total_time = 0;
+ int number = 0;
+ };
+
+ std::map<std::string, Counts> counts () const {
+ return _counts;
+ }
private:
+ void set_internal (boost::optional<std::string> s);
+
/** name to add to the output */
std::string _name;
/** current state */
- std::string _state;
+ boost::optional<std::string> _state;
/** time that _state was entered */
double _time;
- /** time that has been spent in each state so far */
- std::map<std::string, double> _totals;
+ /** total time and number of entries for each state */
+ std::map<std::string, Counts> _counts;
};
+
#endif