diff options
author | tilghman <tilghman@f38db490-d61c-443f-a65b-d21fe96a405b> | 2008-10-01 23:02:25 +0000 |
---|---|---|
committer | tilghman <tilghman@f38db490-d61c-443f-a65b-d21fe96a405b> | 2008-10-01 23:02:25 +0000 |
commit | 0c8cf106ef2b81fddbc9839476f0c666e86bae48 (patch) | |
tree | e5cb3c65a8b2815e66815465a16225d0a82458d6 /include/asterisk/localtime.h | |
parent | e938c5abe7710472e1a350e34bf0e246749ff543 (diff) |
Add schedule extensions to app_meetme. In addition, the reporter found a
problem within strptime(3), which we are correcting here with ast_strptime().
(closes issue #11040)
Reported by: DEA
Patches:
20080910__bug11040.diff.txt uploaded by Corydon76 (license 14)
Tested by: DEA
git-svn-id: http://svn.digium.com/svn/asterisk/trunk@145649 f38db490-d61c-443f-a65b-d21fe96a405b
Diffstat (limited to 'include/asterisk/localtime.h')
-rw-r--r-- | include/asterisk/localtime.h | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/include/asterisk/localtime.h b/include/asterisk/localtime.h index dd92871e9..d9f98f836 100644 --- a/include/asterisk/localtime.h +++ b/include/asterisk/localtime.h @@ -40,9 +40,42 @@ struct ast_tm { int tm_usec; /*!< microseconds */ }; +/*!\brief Timezone-independent version of localtime_r(3). + * \param timep Current time, including microseconds + * \param p_tm Pointer to memory where the broken-out time will be stored + * \param zone Text string of a standard system zoneinfo file. If NULL, the system localtime will be used. + * \retval p_tm is returned for convenience + */ struct ast_tm *ast_localtime(const struct timeval *timep, struct ast_tm *p_tm, const char *zone); + void ast_get_dst_info(const time_t * const timep, int *dst_enabled, time_t *dst_start, time_t *dst_end, int *gmt_off, const char * const zone); + +/*!\brief Timezone-independent version of mktime(3). + * \param tmp Current broken-out time, including microseconds + * \param zone Text string of a standard system zoneinfo file. If NULL, the system localtime will be used. + * \retval A structure containing both seconds and fractional thereof since January 1st, 1970 UTC + */ struct timeval ast_mktime(struct ast_tm * const tmp, const char *zone); + +/*!\brief Special version of strftime(3) that handles fractions of a second. + * Takes the same arguments as strftime(3), with the addition of %q, which + * specifies microseconds. + * \param buf Address in memory where the resulting string will be stored. + * \param len Size of the chunk of memory buf. + * \param format A string specifying the format of time to be placed into buf. + * \param tm Pointer to the broken out time to be used for the format. + * \retval An integer value specifying the number of bytes placed into buf or -1 on error. + */ int ast_strftime(char *buf, size_t len, const char *format, const struct ast_tm *tm); +/*!\brief Special version of strptime(3) which places the answer in the common + * structure ast_tm. Also, unlike strptime(3), ast_strptime() initializes its + * memory prior to use. + * \param s A string specifying some portion of a date and time. + * \param format The format in which the string, s, is expected. + * \param tm The broken-out time structure into which the parsed data is expected. + * \retval A pointer to the first character within s not used to parse the date and time. + */ +char *ast_strptime(const char *s, const char *format, struct ast_tm *tm); + #endif /* _ASTERISK_LOCALTIME_H */ |