SFI Interface Reference

/opt/src/beast/sfi/sfitime.h

SYNOPSIS

DESCRIPTION

_sfi_init_time

/opt/src/beast/sfi/sfitime.h:43

sfi_time_from_string

/opt/src/beast/sfi/sfitime.h:37
SfiTime  sfi_time_from_string 
(const gchar *time_string);
Simple variant of sfi_time_from_string_err().
time_string: string containing human readable date and time
RETURNS: parsed time in micro seconds or 0 on error

sfi_time_from_string_err

/opt/src/beast/sfi/sfitime.h:39
SfiTime  sfi_time_from_string_err 
(const gchar *time_string,
 gchar      **error_p);
Parse date and time from a string of characters and indicate possible errors. Several attempts are made to reconstruct a valid date and time despite possible errors. However, if all attempts fail, the returned time is 0. The time returned is UTC, refer to sfi_time_from_utc() in order to retrieve the local standard time.
time_string: string containing human readable date and time
error_p: location for newly allocated string containing conversion errors
RETURNS: parsed time in micro seconds, may be 0 on error

sfi_time_from_utc

/opt/src/beast/sfi/sfitime.h:33
Convert the Coordinated Universal Time (UTC) ustime into local standard time. This function is MT-safe and may be called from any thread.
ustime: UTC relative time in micro seconds
RETURNS: local standard time in micro seconds

sfi_time_system

/opt/src/beast/sfi/sfitime.h:31
Get the current system time in micro seconds. Subsequent calls to this function do not necessarily return greater values. In fact, a second call may return a value smaller than the first call under certain system conditions. The time returned is UTC, refer to sfi_time_from_utc() in order to retrieve the local standard time. This function is MT-safe and may be called from any thread.
RETURNS: Current system time in micro seconds

sfi_time_to_nice_string

/opt/src/beast/sfi/sfitime.h:36
gchar*  sfi_time_to_nice_string 
(SfiTime      ustime,
 const gchar *elements);
Retrieve the time ustime in human readable form. Within the rnage of date and time formats parsable by sfi_time_from_string(), the nicest display is selected according to the current locale and other user settings. By means of the elements argument, various elemtns of a full date string can be selected:
  • H - display hours
  • M - display minutes
  • S - display seconds
  • d - display day
  • m - display month
  • y - display year
The returned time string describes UTC time and thus contains no time zone or UTC offset information.
ustime: time in micro seconds
elements: string identifying time elements
RETURNS: newly allocated string

sfi_time_to_string

/opt/src/beast/sfi/sfitime.h:34
Retrieve the time ustime in human readable form. The returned time string describes UTC time and thus contains no time zone or UTC offset information.
ustime: time in micro seconds
RETURNS: newly allocated string

sfi_time_to_utc

/opt/src/beast/sfi/sfitime.h:32
Convert the local standard time ustime into Coordinated Universal Time (UTC). This function is MT-safe and may be called from any thread.
ustime: local standard time in micro seconds
RETURNS: UTC relative time in micro seconds