Collaboration diagram for Time Routines:

Data Structures
struct	switch_time_exp_t

Typedefs
typedef int64_t	switch_time_t

typedef int64_t	switch_interval_time_t

typedef struct switch_time_exp_t	switch_time_exp_t

Functions
switch_time_t	switch_time_make (switch_time_t sec, int32_t usec)

switch_time_t	switch_time_now (void)

switch_status_t	switch_time_exp_gmt_get (switch_time_t result, switch_time_exp_t input)

switch_status_t	switch_strftime (char s, switch_size_t retsize, switch_size_t max, const char format, switch_time_exp_t tm)

switch_status_t	switch_strftime_nocheck (char s, switch_size_t retsize, switch_size_t max, const char format, switch_time_exp_t tm)

switch_status_t	switch_rfc822_date (char *date_str, switch_time_t t)

switch_status_t	switch_time_exp_gmt (switch_time_exp_t *result, switch_time_t input)

switch_status_t	switch_time_exp_get (switch_time_t result, switch_time_exp_t input)

switch_status_t	switch_time_exp_lt (switch_time_exp_t *result, switch_time_t input)

switch_status_t	switch_time_exp_tz (switch_time_exp_t *result, switch_time_t input, switch_int32_t offs)

void	switch_sleep (switch_interval_time_t t)

void	switch_micro_sleep (switch_interval_time_t t)

Detailed Description

Typedef Documentation

typedef int64_t switch_interval_time_t

number of microseconds in the interval

Definition at line 191 of file switch_apr.h.

typedef struct switch_time_exp_t switch_time_exp_t

a structure similar to ANSI struct tm with the following differences:

tm_usec isn't an ANSI field
tm_gmtoff isn't an ANSI field (it's a bsdism)

typedef int64_t switch_time_t

number of microseconds since 00:00:00 january 1, 1970 UTC

Definition at line 188 of file switch_apr.h.

Function Documentation

void switch_micro_sleep ( switch_interval_time_t t )

Definition at line 615 of file switch_time.c.

References do_sleep().

 {
         do_sleep(t);
 }

switch_status_t switch_rfc822_date	(	char *	date_str,
		switch_time_t	t
	)

switch_rfc822_date formats dates in the RFC822 format in an efficient manner. It is a fixed length format which requires the indicated amount of storage, including the trailing NUL terminator.

Parameters

date_str	String to write to.
t	the time to convert

Definition at line 338 of file switch_apr.c.

Referenced by switch_event_prep_for_delivery_detailed().

 {
         return apr_rfc822_date(date_str, t);
 }

void switch_sleep ( switch_interval_time_t t )

Sleep for the specified number of micro-seconds.

Parameters

t	desired amount of time to sleep.

Warning: May sleep for longer than the specified time.

Definition at line 620 of file switch_time.c.

References do_sleep(), globals, and switch_cond_yield().

Referenced by main(), and switch_msleep().

 {
 
         if (globals.RUNNING != 1 || t < 1000 || t >= 10000) {
                 do_sleep(t);
                 return;
         }
 #ifndef DISABLE_1MS_COND
         if (globals.use_cond_yield == 1) {
                 switch_cond_yield(t);
                 return;
         }
 #endif
 
         do_sleep(t);
 }

switch_status_t switch_strftime	(	char *	s,
		switch_size_t *	retsize,
		switch_size_t	max,
		const char *	format,
		switch_time_exp_t *	tm
	)

formats the exploded time according to the format specified

Parameters

s	string to write to
retsize	The length of the returned string
max	The maximum length of the string
format	The format for the time string
tm	The time to convert

Definition at line 127 of file switch_apr.c.

References SWITCH_STATUS_FALSE.

Referenced by switch_xml_std_datetime_check().

 {
         const char *p = format;
 
         if (!p)
                 return SWITCH_STATUS_FALSE;
 
         while (*p) {
                 if (*p == '%') {
                         switch (*(++p)) {
                         case 'C':
                         case 'D':
                         case 'r':
                         case 'R':
                         case 'T':
                         case 'e':
                         case 'a':
                         case 'A':
                         case 'b':
                         case 'B':
                         case 'c':
                         case 'd':
                         case 'H':
                         case 'I':
                         case 'j':
                         case 'm':
                         case 'M':
                         case 'p':
                         case 'S':
                         case 'U':
                         case 'w':
                         case 'W':
                         case 'x':
                         case 'X':
                         case 'y':
                         case 'Y':
                         case 'z':
                         case 'Z':
                         case '%':
                                 p++;
                                 continue;
                         case '\0':
                         default:
                                 return SWITCH_STATUS_FALSE;
                         }
                 }
                 p++;
         }
 
         return apr_strftime(s, retsize, max, format, (apr_time_exp_t *) tm);
 }

switch_status_t switch_strftime_nocheck	(	char *	s,
		switch_size_t *	retsize,
		switch_size_t	max,
		const char *	format,
		switch_time_exp_t *	tm
	)

formats the exploded time according to the format specified (does not validate format string)

Parameters

s	string to write to
retsize	The length of the returned string
max	The maximum length of the string
format	The format for the time string
tm	The time to convert

Definition at line 179 of file switch_apr.c.

Referenced by switch_channel_set_timestamps(), switch_console_printf(), switch_event_prep_for_delivery_detailed(), and switch_strftime_tz().

 {
         return apr_strftime(s, retsize, max, format, (apr_time_exp_t *) tm);
 }

switch_status_t switch_time_exp_get	(	switch_time_t *	result,
		switch_time_exp_t *	input
	)

Convert time value from human readable format to a numeric apr_time_t e.g. elapsed usec since epoch

Parameters

result	the resulting imploded time
input	the input exploded time

Definition at line 318 of file switch_apr.c.

Referenced by switch_str_time().

 {
         return apr_time_exp_get((apr_time_t *) result, (apr_time_exp_t *) input);
 }

switch_status_t switch_time_exp_gmt	(	switch_time_exp_t *	result,
		switch_time_t	input
	)

convert a time to its human readable components in GMT timezone

Parameters

result	the exploded time
input	the time to explode

Definition at line 333 of file switch_apr.c.

Referenced by process_rtcp_report(), and rtcp_generate_sender_info().

 {
         return apr_time_exp_gmt((apr_time_exp_t *) result, input);
 }

switch_status_t switch_time_exp_gmt_get	(	switch_time_t *	result,
		switch_time_exp_t *	input
	)

Convert time value from human readable format to a numeric apr_time_t that always represents GMT

Parameters

result	the resulting imploded time
input	the input exploded time

Definition at line 313 of file switch_apr.c.

Referenced by switch_str_time().

 {
         return apr_time_exp_gmt_get((apr_time_t *) result, (apr_time_exp_t *) input);
 }

switch_status_t switch_time_exp_lt	(	switch_time_exp_t *	result,
		switch_time_t	input
	)

convert a time to its human readable components in local timezone

Parameters

result	the exploded time
input	the time to explode

Definition at line 323 of file switch_apr.c.

Referenced by switch_channel_set_timestamps(), switch_console_printf(), switch_event_prep_for_delivery_detailed(), switch_log_vprintf(), switch_str_time(), and switch_xml_std_datetime_check().

 {
         return apr_time_exp_lt((apr_time_exp_t *) result, input);
 }

switch_status_t switch_time_exp_tz	(	switch_time_exp_t *	result,
		switch_time_t	input,
		switch_int32_t	offs
	)

convert a time to its human readable components in a specific timezone with offset

Parameters

result	the exploded time
input	the time to explode

Definition at line 328 of file switch_apr.c.

Referenced by switch_xml_std_datetime_check().

 {
         return apr_time_exp_tz((apr_time_exp_t *) result, input, (apr_int32_t) offs);
 }

switch_time_t switch_time_make	(	switch_time_t	sec,
		int32_t	usec
	)

Definition at line 343 of file switch_apr.c.

 {
         return ((switch_time_t) (sec) * APR_USEC_PER_SEC + (switch_time_t) (usec));
 }

switch_time_t switch_time_now ( void )

Returns: the current time

Definition at line 302 of file switch_apr.c.

Referenced by process_rtcp_report(), record_callback(), rtcp_generate_report_block(), rtcp_generate_sender_info(), rtp_common_write(), switch_channel_clear_flag(), switch_channel_perform_hangup(), switch_channel_set_flag_value(), switch_core_media_read_frame(), switch_core_session_exec(), switch_core_session_request_xml(), switch_ivr_dmachine_check_timeout(), switch_ivr_dmachine_feed(), switch_jb_pop_nack(), switch_micro_time_now(), SWITCH_MODULE_RUNTIME_FUNCTION(), switch_rtp_create(), switch_rtp_enable_vad(), switch_time_sync(), time_now(), and timer_generic_sync().

 {
 #if defined(HAVE_CLOCK_GETTIME) && defined(SWITCH_USE_CLOCK_FUNCS)
         struct timespec ts;
         clock_gettime(CLOCK_REALTIME, &ts);
         return ts.tv_sec * APR_USEC_PER_SEC + (ts.tv_nsec / 1000);
 #else
         return (switch_time_t) apr_time_now();
 #endif
 }

Data Structures

Typedefs

Functions

Detailed Description

Typedef Documentation

Function Documentation