Function

GLibidle_add_once

Declaration

guint
g_idle_add_once (
  GSourceOnceFunc function,
  gpointer data
)

Description

Adds a function to be called whenever there are no higher priority events pending to the default main loop. The function is given the default idle priority, G_PRIORITY_DEFAULT_IDLE.

The function will only be called once and then the source will be automatically removed from the main context.

This function otherwise behaves like g_idle_add().

Available since:2.74
This function is not directly available to language bindings

Parameters

function

Type: GSourceOnceFunc

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.