Added some comments.

FossilOrigin-Name: 0be0963ac9db29acebbd006a3d2a0ce283cbe41e79244f528f1280c3ed07b891
This commit is contained in:
7u83@mail.ru 2015-10-17 17:28:07 +00:00
parent 04e76bc280
commit 70a9e8efae
1 changed files with 15 additions and 6 deletions

View File

@ -24,7 +24,7 @@
#include <sys/time.h> #include <sys/time.h>
/** /**
* @defgroup TimerFunctions Timer Functions * @defgroup TimerFunctions Timer & Clock Functions
* @{ * @{
*/ */
@ -58,24 +58,33 @@ typedef time_t cw_timer_t;
/** /**
* Define a clock variable to measure runtime (not CPU runtime, but * Define a clock variable to measure runtime (not CPU runtime, but
* real time). This variable can be used with #cw_clock_start * real time). The created variable can be used with #cw_clock_start
* and #cw_clock_lap. * and #cw_clock_lap.
*
* @param c name of the variable * @param c name of the variable
*
* Example:
* @code
* CW_CLOCK_DEFINE(clk);
* cw_clock_start(clk);
* // do something ...
* int t = cw_clock_lap(clk);
* printf("Caclulation took %d seconds\n",t);
* @endcode
*
*/ */
#define CLOCK_DEFINE(c)\ #define CW_CLOCK_DEFINE(c)\
struct timeval c; struct timeval c;
/** /**
* Start the clock (stop watch), start measuring time * Start the clock (stop watch), start measuring time
* @param c a pounter to a variable defined with #DEFINE_CLOCK * @param c a pouiter to a variable defined with #CW_CLOCK_DEFINE
*/ */
#define cw_clock_start(c)\ #define cw_clock_start(c)\
gettimeofday(c,NULL); gettimeofday(c,NULL);
/** /**
* Get lap time. (stop watch) * Get lap time. (stop watch)
* @param tv pointer to a clock variable defined with #CLOCK_DEFINE * @param tv pointer to a clock variable defined with #CW_CLOCK_DEFINE
* @return lap time in seconds. * @return lap time in seconds.
*/ */
static inline double cw_clock_lap(struct timeval *tv) static inline double cw_clock_lap(struct timeval *tv)