clock

NAME

clock - Determine processor time

SYNOPSIS

#include <time.h>
 clock_t clock(void);

DESCRIPTION

The R clock () function returns an approximation of processor time used by the program.

RETURN VALUE

The value returned is the CPU time used so far as a R clock_t ; to get the number of seconds used, divide by R CLOCKS_PER_SEC . If the processor time used is not available or its value cannot be represented, the function returns the value R (clock_t)-1 .

CONFORMING TO

C89, C99, POSIX.1-2001. POSIX requires that CLOCKS_PER_SEC equals 1000000 independent of the actual resolution.

NOTES

The C standard allows for arbitrary values at the start of the program; subtract the value returned from a call to R clock () at the start of the program to get maximum portability.
Note that the time can wrap around. On a 32bit system where CLOCKS_PER_SEC equals 1000000 this function will return the same value approximately every 72 minutes.
On several other implementations, the value returned by R clock () also includes the times of any children whose status has been collected via wait(2) (or another wait-type call). Linux does not include the times of waited-for children in the value returned by R clock (). The times(2) function, which explicitly returns (separate) information about the caller and its children, may be preferable.

SEE ALSO