// This file is under GNU General Public License 3.0

// see LICENSE.txt

#pragma once

#include <time.h>

#include "dynamic_api.h"

#ifdef __cplusplus

extern "C" {

#endif

// for time values all functions are using POSIX struct tm

typedef struct tm timestamp;

// new_timestamp() - allocate a new timestamp

//

//  parameters:

//      clock (in)      initial value or 0 if not available

//

//  return value:

//      pointer to timestamp object or NULL if out of memory

DYNAMIC_API timestamp * new_timestamp(time_t clock);

// free_timestamp() - free memory occupied by timestamp

//

//  parameters:

//      ts (in)         pointer to timestamp to free

DYNAMIC_API void free_timestamp(timestamp *ts);

// timestamp_dup() - duplicate a timestamp

//

//  parameters:

//      src (in)        pointer to timestamp to duplicate

//

//  return value:

//      pointer to copy or NULL if out of memory

DYNAMIC_API timestamp * timestamp_dup(const timestamp *src);

#ifdef __cplusplus

}

#endif