Function

Gmtimeout_add_seconds_once

Declaration [src]

guint
gm_timeout_add_seconds_once (
  int seconds,
  GSourceFunc function,
  gpointer data
)

Description [src]

Sets a function to be called after a timeout with the default priority, G_PRIORITY_DEFAULT. Correctly calculates the timeout even when the system is suspended in between.

This internally creates a main loop source using g_timeout_source_new_seconds() and attaches it to the main loop context using g_source_attach().

The timeout given is in terms of CLOCK_BOOTTIME time, it hence is also correct across suspend and resume. If that doesn’t matter use g_timeout_add_seconds instead.

Note that glib’s g_timeout_add_seconds() doesn’t take system suspend/resume into account: https://gitlab.gnome.org/GNOME/glib/-/issues/2739

This function is not directly available to language bindings.

The implementation of this method is provided by gm_timeout_add_seconds_once_full() in language bindings

Parameters

seconds

Type: int

The timeout in seconds.

function

Type: GSourceFunc

Function to call.

data

Type: gpointer

Data to pass to function.

The argument can be NULL.

The data is owned by the caller of the function.

Return value

Type: guint

The ID (greater than 0) of the event source.