timex.h

Go to the documentation of this file.

/*
 * Copyright (C) 2010 Kaspar Schleiser <kaspar@schleiser.de>
 * Copyright (C) 2014 Oliver Hahm <oliver.hahm@inria.fr>
 *
 * This file is subject to the terms and conditions of the GNU Lesser
 * General Public License v2.1. See the file LICENSE in the top level
 * directory for more details.
 */
 
 
#ifndef TIMEX_H
#define TIMEX_H
 
#include <stdint.h>
#include <inttypes.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define US_PER_SEC          (1000000LU)
 
#define SEC_PER_MIN         (60LU)
 
#define CS_PER_SEC          (100LU)
 
#define MS_PER_SEC          (1000LU)
 
#define US_PER_MS           (1000LU)
 
#define US_PER_CS  (10000U)
 
#define NS_PER_US           (1000LU)
 
#define NS_PER_SEC  (1000000000U)
 
#define TIMEX_MAX_STR_LEN   (20)
/* 20 =
 *  + 10 byte: 2^32-1 for seconds
 *  + 1 byte: decimal point
 *  + 6 byte: microseconds (normalized)
 *  + 2 byte: " s" (unit)
 *  + 1 byte: '\0'
 */
 
typedef struct {
    uint32_t seconds;       
    uint32_t microseconds;  
} timex_t;
 
timex_t timex_add(const timex_t a, const timex_t b);
 
timex_t timex_sub(const timex_t a, const timex_t b);
 
timex_t timex_set(uint32_t seconds, uint32_t microseconds);
 
int timex_cmp(const timex_t a, const timex_t b);
 
static inline void timex_normalize(timex_t *time)
{
    time->seconds += (time->microseconds / US_PER_SEC);
    time->microseconds %= US_PER_SEC;
}
 
static inline int timex_isnormalized(const timex_t *time)
{
    return (time->microseconds < US_PER_SEC);
}
 
static inline uint64_t timex_uint64(const timex_t a)
{
    return (uint64_t) a.seconds * US_PER_SEC + a.microseconds;
}
 
static inline timex_t timex_from_uint64(const uint64_t timestamp)
{
    return timex_set(timestamp / US_PER_SEC, timestamp % US_PER_SEC);
}
 
const char *timex_to_str(timex_t t, char *timestamp);
 
#ifdef __cplusplus
}
#endif
 
#endif /* TIMEX_H */