epicsTime.cpp File Reference

#include <stdexcept>
#include <ctype.h>
#include <stddef.h>
#include <stdio.h>
#include <string.h>
#include <limits.h>
#include <float.h>
#include <string>
#include "locationException.h"
#include "epicsAssert.h"
#include "epicsVersion.h"
#include "envDefs.h"
#include "epicsTime.h"
#include "osiSock.h"
#include "epicsStdio.h"

Include dependency graph for epicsTime.cpp:

Go to the source code of this file.

Classes
class	epicsTimeLoadTimeInit
struct	l_fp
	Network Time Protocol timestamp. More...

Functions
LIBCOM_API int epicsStdCall	epicsTimeToTime_t (time_t *pDest, const epicsTimeStamp *pSrc)
	Convert epicsTimeStamp to ANSI C time_t. More...
LIBCOM_API int epicsStdCall	epicsTimeFromTime_t (epicsTimeStamp *pDest, time_t src)
	Convert ANSI C time_t to epicsTimeStamp. More...
LIBCOM_API int epicsStdCall	epicsTimeToTM (struct tm *pDest, unsigned long *pNSecDest, const epicsTimeStamp *pSrc)
	Convert epicsTimeStamp to struct tm in local time zone. More...
LIBCOM_API int epicsStdCall	epicsTimeToGMTM (struct tm *pDest, unsigned long *pNSecDest, const epicsTimeStamp *pSrc)
	Convert epicsTimeStamp to struct tm in UTC/GMT. More...
LIBCOM_API int epicsStdCall	epicsTimeFromTM (epicsTimeStamp *pDest, const struct tm *pSrc, unsigned long nSecSrc)
	Set epicsTimeStamp from struct tm in local time zone. More...
LIBCOM_API int epicsStdCall	epicsTimeFromGMTM (epicsTimeStamp *pDest, const struct tm *pSrc, unsigned long nSecSrc)
	Set epicsTimeStamp from struct tm in UTC/GMT. More...
LIBCOM_API int epicsStdCall	epicsTimeToTimespec (struct timespec *pDest, const epicsTimeStamp *pSrc)
	Convert epicsTimeStamp to struct timespec More...
LIBCOM_API int epicsStdCall	epicsTimeFromTimespec (epicsTimeStamp *pDest, const struct timespec *pSrc)
	Set epicsTimeStamp from struct timespec More...
LIBCOM_API int epicsStdCall	epicsTimeToTimeval (struct timeval *pDest, const epicsTimeStamp *pSrc)
	Convert epicsTimeStamp to struct timeval More...
LIBCOM_API int epicsStdCall	epicsTimeFromTimeval (epicsTimeStamp *pDest, const struct timeval *pSrc)
	Set epicsTimeStamp from struct timeval More...
LIBCOM_API double epicsStdCall	epicsTimeDiffInSeconds (const epicsTimeStamp *pLeft, const epicsTimeStamp *pRight)
	Time difference between left and right in seconds. More...
LIBCOM_API void epicsStdCall	epicsTimeAddSeconds (epicsTimeStamp *pDest, double seconds)
	Add some number of seconds to dest. More...
LIBCOM_API int epicsStdCall	epicsTimeEqual (const epicsTimeStamp *pLeft, const epicsTimeStamp *pRight)
	left equals right More...
LIBCOM_API int epicsStdCall	epicsTimeNotEqual (const epicsTimeStamp *pLeft, const epicsTimeStamp *pRight)
	left not equal to right More...
LIBCOM_API int epicsStdCall	epicsTimeLessThan (const epicsTimeStamp *pLeft, const epicsTimeStamp *pRight)
	left was before right More...
LIBCOM_API int epicsStdCall	epicsTimeLessThanEqual (const epicsTimeStamp *pLeft, const epicsTimeStamp *pRight)
	right was no later than left More...
LIBCOM_API int epicsStdCall	epicsTimeGreaterThan (const epicsTimeStamp *pLeft, const epicsTimeStamp *pRight)
	left was after right More...
LIBCOM_API int epicsStdCall	epicsTimeGreaterThanEqual (const epicsTimeStamp *pLeft, const epicsTimeStamp *pRight)
	right was not before left More...
LIBCOM_API size_t epicsStdCall	epicsTimeToStrftime (char *pBuff, size_t bufLength, const char *pFormat, const epicsTimeStamp *pTS)
	Convert epicsTimeStamp to string. See epicsTime::strftime() More...
LIBCOM_API void epicsStdCall	epicsTimeShow (const epicsTimeStamp *pTS, unsigned interestLevel)
	Dump current state to stdout. More...

Function Documentation

LIBCOM_API void epicsStdCall epicsTimeAddSeconds	(	epicsTimeStamp *	pDest,
		double	seconds
	)

Add some number of seconds to dest.

Definition at line 1057 of file epicsTime.cpp.

    {
        try {
            *pDest = epicsTime (*pDest) + seconds;
        }
        catch ( ... ) {
            *pDest = epicsTime ();
        }
    }

LIBCOM_API double epicsStdCall epicsTimeDiffInSeconds	(	const epicsTimeStamp *	pLeft,
		const epicsTimeStamp *	pRight
	)

Time difference between left and right in seconds.

Definition at line 1048 of file epicsTime.cpp.

    {
        try {
            return epicsTime (*pLeft) - epicsTime (*pRight);
        }
        catch (...) {
            return - DBL_MAX;
        }
    }

LIBCOM_API int epicsStdCall epicsTimeEqual	(	const epicsTimeStamp *	pLeft,
		const epicsTimeStamp *	pRight
	)

left equals right

Definition at line 1066 of file epicsTime.cpp.

    {
        try {
            return epicsTime (*pLeft) == epicsTime (*pRight);
        }
        catch ( ... ) {
            return 0;
        }
    }

LIBCOM_API int epicsStdCall epicsTimeFromGMTM	(	epicsTimeStamp *	pDest,
		const struct tm *	pSrc,
		unsigned long	nSecSrc
	)

Set epicsTimeStamp from struct tm in UTC/GMT.

Definition at line 995 of file epicsTime.cpp.

    {
        try {
            gm_tm_nano_sec tmns;
            tmns.ansi_tm = *pSrc;
            tmns.nSec = nSecSrc;
            *pDest = epicsTime (tmns);
        }
        catch (...) {
            return S_time_conversion;
        }
        return epicsTimeOK;
    }

LIBCOM_API int epicsStdCall epicsTimeFromTime_t	(	epicsTimeStamp *	pDest,
		time_t	src
	)

Convert ANSI C time_t to epicsTimeStamp.

Definition at line 944 of file epicsTime.cpp.

    {
        try {
            time_t_wrapper dst;
            dst.ts = src;
            *pDest = epicsTime ( dst );
        }
        catch (...) {
            return S_time_conversion;
        }
        return epicsTimeOK;
    }

LIBCOM_API int epicsStdCall epicsTimeFromTimespec	(	epicsTimeStamp *	pDest,
		const struct timespec *	pSrc
	)

Set epicsTimeStamp from struct timespec

Definition at line 1018 of file epicsTime.cpp.

    {
        try {
            *pDest = epicsTime (*pSrc);
        }
        catch (...) {
            return S_time_conversion;
        }
        return epicsTimeOK;
    }

LIBCOM_API int epicsStdCall epicsTimeFromTimeval	(	epicsTimeStamp *	pDest,
		const struct timeval *	pSrc
	)

Set epicsTimeStamp from struct timeval

Definition at line 1038 of file epicsTime.cpp.

    {
        try {
            *pDest = epicsTime (*pSrc);
        }
        catch (...) {
            return S_time_conversion;
        }
        return epicsTimeOK;
    }

LIBCOM_API int epicsStdCall epicsTimeFromTM	(	epicsTimeStamp *	pDest,
		const struct tm *	pSrc,
		unsigned long	nSecSrc
	)

Set epicsTimeStamp from struct tm in local time zone.

Definition at line 982 of file epicsTime.cpp.

    {
        try {
            local_tm_nano_sec tmns;
            tmns.ansi_tm = *pSrc;
            tmns.nSec = nSecSrc;
            *pDest = epicsTime (tmns);
        }
        catch (...) {
            return S_time_conversion;
        }
        return epicsTimeOK;
    }

LIBCOM_API int epicsStdCall epicsTimeGreaterThan	(	const epicsTimeStamp *	pLeft,
		const epicsTimeStamp *	pRight
	)

left was after right

Definition at line 1102 of file epicsTime.cpp.

    {
        try {
            return epicsTime (*pLeft) > epicsTime (*pRight);
        }
        catch ( ... ) {
            return 0;
        }
    }

LIBCOM_API int epicsStdCall epicsTimeGreaterThanEqual	(	const epicsTimeStamp *	pLeft,
		const epicsTimeStamp *	pRight
	)

right was not before left

Definition at line 1111 of file epicsTime.cpp.

    {
        try {
            return epicsTime (*pLeft) >= epicsTime (*pRight);
        }
        catch ( ... ) {
            return 0;
        }
    }

LIBCOM_API int epicsStdCall epicsTimeLessThan	(	const epicsTimeStamp *	pLeft,
		const epicsTimeStamp *	pRight
	)

left was before right

Definition at line 1084 of file epicsTime.cpp.

    {
        try {
            return epicsTime (*pLeft) < epicsTime (*pRight);
        }
        catch ( ... ) {
            return 0;
        }
    }

LIBCOM_API int epicsStdCall epicsTimeLessThanEqual	(	const epicsTimeStamp *	pLeft,
		const epicsTimeStamp *	pRight
	)

right was no later than left

Definition at line 1093 of file epicsTime.cpp.

    {
        try {
            return epicsTime (*pLeft) <= epicsTime (*pRight);
        }
        catch ( ... ) {
            return 0;
        }
    }

LIBCOM_API int epicsStdCall epicsTimeNotEqual	(	const epicsTimeStamp *	pLeft,
		const epicsTimeStamp *	pRight
	)

left not equal to right

Definition at line 1075 of file epicsTime.cpp.

    {
        try {
            return epicsTime (*pLeft) != epicsTime (*pRight);
        }
        catch ( ... ) {
            return 1;
        }
    }

LIBCOM_API void epicsStdCall epicsTimeShow	(	const epicsTimeStamp *	pTS,
		unsigned	interestLevel
	)

Dump current state to stdout.

Definition at line 1129 of file epicsTime.cpp.

    {
        try {
            epicsTime(*pTS).show (interestLevel);
        }
        catch ( ... ) {
            printf ( "Invalid epicsTimeStamp\n" );
        }
    }

LIBCOM_API int epicsStdCall epicsTimeToGMTM	(	struct tm *	pDest,
		unsigned long *	pNSecDest,
		const epicsTimeStamp *	pSrc
	)

Convert epicsTimeStamp to struct tm in UTC/GMT.

Definition at line 969 of file epicsTime.cpp.

    {
        try {
            gm_tm_nano_sec gmtmns = epicsTime (*pSrc);
            *pDest = gmtmns.ansi_tm;
            if (pNSecDest)
                *pNSecDest = gmtmns.nSec;
        }
        catch (...) {
            return S_time_conversion;
        }
        return epicsTimeOK;
    }

LIBCOM_API size_t epicsStdCall epicsTimeToStrftime	(	char *	pBuff,
		size_t	bufLength,
		const char *	pFormat,
		const epicsTimeStamp *	pTS
	)

Convert epicsTimeStamp to string. See epicsTime::strftime()

Definition at line 1120 of file epicsTime.cpp.

    {
        try {
            return epicsTime(*pTS).strftime (pBuff, bufLength, pFormat);
        }
        catch ( ... ) {
            return 0;
        }
    }

LIBCOM_API int epicsStdCall epicsTimeToTime_t	(	time_t *	pDest,
		const epicsTimeStamp *	pSrc
	)

Convert epicsTimeStamp to ANSI C time_t.

Definition at line 933 of file epicsTime.cpp.

    {
        try {
            time_t_wrapper dst = epicsTime (*pSrc);
            *pDest = dst.ts;
        }
        catch (...) {
            return S_time_conversion;
        }
        return epicsTimeOK;
    }

LIBCOM_API int epicsStdCall epicsTimeToTimespec	(	struct timespec *	pDest,
		const epicsTimeStamp *	pSrc
	)

Convert epicsTimeStamp to struct timespec

Definition at line 1008 of file epicsTime.cpp.

    {
        try {
            *pDest = epicsTime (*pSrc);
        }
        catch (...) {
            return S_time_conversion;
        }
        return epicsTimeOK;
    }

LIBCOM_API int epicsStdCall epicsTimeToTimeval	(	struct timeval *	pDest,
		const epicsTimeStamp *	pSrc
	)

Convert epicsTimeStamp to struct timeval

Definition at line 1028 of file epicsTime.cpp.

    {
        try {
            *pDest = epicsTime (*pSrc);
        }
        catch (...) {
            return S_time_conversion;
        }
        return epicsTimeOK;
    }

LIBCOM_API int epicsStdCall epicsTimeToTM	(	struct tm *	pDest,
		unsigned long *	pNSecDest,
		const epicsTimeStamp *	pSrc
	)

Convert epicsTimeStamp to struct tm in local time zone.

Definition at line 956 of file epicsTime.cpp.

    {
        try {
            local_tm_nano_sec tmns = epicsTime (*pSrc);
            *pDest = tmns.ansi_tm;
            if (pNSecDest)
                *pNSecDest = tmns.nSec;
        }
        catch (...) {
            return S_time_conversion;
        }
        return epicsTimeOK;
    }