cctools
Typedefs | Functions
timestamp.h File Reference

Portable routines for high resolution timing. More...

#include "int_sizes.h"
#include <time.h>

Go to the source code of this file.

Typedefs

typedef UINT64_T timestamp_t
 A type to hold the current time, in microseconds since January 1st, 1970. More...
 

Functions

timestamp_t timestamp_get (void)
 Get the current time. More...
 
int timestamp_fmt (char *buf, size_t size, const char *fmt, timestamp_t ts)
 Formats timestamp_t ts according to the format specification fmt and stores the result as a string in array buf. More...
 
void timestamp_sleep (timestamp_t interval)
 Sleep for a specified time. More...
 
time_t timestamp_file (const char *file)
 Get the last modified time of a file. More...
 

Detailed Description

Portable routines for high resolution timing.

Typedef Documentation

typedef UINT64_T timestamp_t

A type to hold the current time, in microseconds since January 1st, 1970.

Function Documentation

timestamp_t timestamp_get ( void  )

Get the current time.

Returns
The current time, in microseconds since January 1st, 1970.
int timestamp_fmt ( char *  buf,
size_t  size,
const char *  fmt,
timestamp_t  ts 
)

Formats timestamp_t ts according to the format specification fmt and stores the result as a string in array buf.

Parameters
bufThe array that holds the formatted string.
sizeThe size of array buf.
fmtThe specification of the desired format.
tsThe time value to format.
Returns
The number of characters placed in the array buf.
void timestamp_sleep ( timestamp_t  interval)

Sleep for a specified time.

Parameters
intervalThe number of microseconds to sleep for.
time_t timestamp_file ( const char *  file)

Get the last modified time of a file.

Parameters
fileThe path of the file to examine.
Returns
The modification time, in seconds since January 1st, 1970.