Timer

Object Hierarchy:

Description:

[ Compact ]
[ CCode ( free_function = "g_timer_destroy" ) ]
public class Timer

`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.

Example: Timers:

public static int main (string[] args) {
	ulong microseconds;
	double seconds;

	// create a timer object:
	Timer timer = new Timer ();

	// 1. measurement, part 1:
	for (int i = 0; i < 10000; i++);
	timer.stop ();

 	seconds = timer.elapsed (out microseconds);
	print ("1.1: %s, %lu\n", seconds.to_string (), microseconds);

	// 1. measurement, part 2:
	timer.@continue ();
	for (int i = 0; i < 100000; i++);
	timer.stop ();

 	seconds = timer.elapsed (out microseconds);
	print ("1.2: %s, %lu\n", seconds.to_string (), microseconds);


	// 2. measurement:
	timer.reset ();
	for (int i = 0; i < 10000; i++);
	for (int i = 0; i < 100000; i++);
	timer.stop ();

 	seconds = timer.elapsed (out microseconds);
	print ("2.1: %s, %lu\n", seconds.to_string (), microseconds);
	return 0;
}

valac --pkg glib-2.0 GLib.Timer.vala

Namespace: GLib

Package: glib-2.0

Content:

Creation methods:

public Timer ()

Methods:

public void @continue ()
Resumes a timer that has previously been stopped with stop.
public double elapsed (out ulong microseconds = null)
If this has been started but not stopped, obtains the time since the timer was started.
public bool is_active ()
Exposes whether the timer is currently active.
public void reset ()
This function is useless; it's fine to call start on an already-started timer to reset the start time, so reset serves no purpose.
public void start ()
Marks a start time, so that future calls to elapsed will report the time since start was called.
public void stop ()
Marks an end time, so calls to elapsed will return the difference between this end time and the start time.