Ecore time functions

---

These are function to retrieve time in a given format.

Examples:

• ecore_time - Differences between time functions

Functions
double	ecore_time_get (void)
double	ecore_time_unix_get (void)
double	ecore_loop_time_get (void)

---

Function Documentation

double ecore_loop_time_get

(

void

)

Retrieves the time at which the last loop stopped waiting for timeouts or events.

This gets the time that the main loop ceased waiting for timouts and/or events to come in or for signals or any other interrupt source. This should be considered a reference point for all time based activity that should calculate its timepoint from the return of ecore_loop_time_get(). Use this UNLESS you absolutely must get the current actual timepoint - then use ecore_time_get(). Note that this time is meant to be used as relative to other times obtained on this run. If you need absolute time references, use ecore_time_unix_get() instead.

This function can be called before any loop has ever been run, but either ecore_init() or ecore_time_get() must have been called once.

Returns:

The number of seconds. Start time is not defined (it may be when the machine was booted, unix time, etc), all it is defined is that it never goes backwards (unless you got big critical messages when the application started).

Since :

2.3

Examples:

ecore_time_functions_example.c.

double ecore_time_get

(

void

)

Retrieves the current system time as a floating point value in seconds.

This uses a monotonic clock and thus never goes back in time while machine is live (even if user changes time or timezone changes, however it may be reset whenever the machine is restarted).

Returns:

The number of seconds. Start time is not defined (it may be when the machine was booted, unix time, etc), all it is defined is that it never goes backwards (unless you got big critical messages when the application started).

See also:

ecore_loop_time_get().

ecore_time_unix_get().

Since :

2.3

Examples:

ecore_poller_example.c, ecore_time_functions_example.c, and ecore_timer_example.c.

double ecore_time_unix_get

(

void

)

Retrieves the current UNIX time as a floating point value in seconds.

See also:

ecore_time_get().

ecore_loop_time_get().

Returns:

The number of seconds since 12.00AM 1st January 1970.

Since :

2.3

Examples:

ecore_time_functions_example.c.