glib:idle-add (func &key priority)

func -- a g:source-func callback function to call
priority -- an integer with the priority of the idle source, typically this will be in the range between g:+priority-default-idle+ and g:+priority-high-idle+

The unsigned integer ID greater than 0 of the event source.

Adds a function to be called whenever there are no higher priority events pending to the default main loop. The priority keyword argument has the g:+priority-default-idle+ default value. If the function returns false it is automatically removed from the list of event sources and will not be called again.

This internally creates a main loop source using the g:idle-source-new function and attaches it to the main loop context using the g:source-attach function. You can do these steps manually if you need greater control.