Description
GTimer records a start time, and counts microseconds elapsed since
that time. This is done somewhat differently on different platforms,
and can be tricky to get exactly right, so GTimer provides a
portable/convenient interface.
Functions
g_timer_new ()
GTimer *
g_timer_new (void);
Creates a new timer, and starts timing (i.e. g_timer_start() is
implicitly called for you).
g_timer_stop ()
void
g_timer_stop (GTimer *timer);
Marks an end time, so calls to g_timer_elapsed() will return the
difference between this end time and the start time.
g_timer_continue ()
void
g_timer_continue (GTimer *timer);
Resumes a timer that has previously been stopped with
g_timer_stop(). g_timer_stop() must be called before using this
function.
Since: 2.4
g_timer_elapsed ()
gdouble
g_timer_elapsed (GTimer *timer,
gulong *microseconds);
If timer
has been started but not stopped, obtains the time since
the timer was started. If timer
has been stopped, obtains the
elapsed time between the time it was started and the time it was
stopped. The return value is the number of seconds elapsed,
including any fractional part. The microseconds
out parameter is
essentially useless.
Returns
seconds elapsed as a floating point value, including any
fractional part.
g_timer_reset ()
void
g_timer_reset (GTimer *timer);
This function is useless; it's fine to call g_timer_start() on an
already-started timer to reset the start time, so g_timer_reset()
serves no purpose.
g_timer_destroy ()
void
g_timer_destroy (GTimer *timer);
Destroys a timer, freeing associated resources.
g_timer_is_active ()
gboolean
g_timer_is_active (GTimer *timer);
Exposes whether the timer is currently active.
Returns
TRUE if the timer is running, FALSE otherwise
Since: 2.62