add_watch_full
Description:
public uint add_watch_full (
int priority,
owned BusFunc func)
Adds a bus watch to the default main context with the given priority (e.g.
DEFAULT).
Since 0.10.33 it is also possible to use a non-default main context set up using
push_thread_default (before one had to create a bus watch
source and attach it to the desired main context 'manually').
This function is used to receive asynchronous messages in the main loop. There can only be a single bus watch per bus, you must remove it
before you can set a new one.
When func is called, the message belongs to the caller; if you want to keep a copy of it, call
@ref before leaving func.
The watch can be removed using remove or by returning FALSE from
func.
Parameters:
| priority |
The priority of the watch. |
| func |
A function to call when a message is received. |
| notify |
the function to call when the source is removed. |
| user_data |
user data passed to func. |
Returns:
| The event source id. MT safe. |
