Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
xt_tic(3)		    Library Functions Manual		       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)

								       xt_tic(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xt_tic&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help