xt_tic(3)

NAME
xt_tic() - Record current high-resolution clock time

LIBRARY
#include <xtend/time.h>
-lxtend

SYNOPSIS
int     xt_tic(struct timeval *start_time, struct rusage *start_usage)

ARGUMENTS
start_time  A struct timeval structure populated by xt_tic()

DESCRIPTION
xt_tic() records the current time in a struct timeval structure. It is a simple wrapper around gettimeofday(2) meant for use with xt_toc(3), which reports elapsed time since the xt_tic() call. The xt_tic() and xt_toc() functions are used to accurately determine the elapsed time of a segment of code, such as a loop that is suspected to be costly. xt_tic() is inserted into the program just before the code and xt_toc() immediately after.

RETURN VALUES
The exit status of gettimeofday(2)

EXAMPLES
struct timeval  start_time;
struct rusage   start_usage;
xt_tic(&start_time, &start_usage);
// Code for which elapsed time is to be measured
for (c = 0; c < bignum; ++c)
{
    ...
}
xt_toc(stderr, "Elapsed time for loop:n", &start_time, &start_usage);

SEE ALSO
xt_toc(3), xt_difftimeofday(3), gettimeofday(2)