Function

GLibHooknext_valid

Declaration

GHook*
g_hook_next_valid (
  GHookList* hook_list,
  GHook* hook,
  gboolean may_be_in_call
)

Description

Returns the next GHook in a GHookList which has not been destroyed. The reference count for the GHook is incremented, so you must call g_hook_unref() to restore it when no longer needed. (Or continue to call g_hook_next_valid() until NULL is returned.)

Parameters

hook_list GHookList
 

A GHookList.

 The data is owned by the caller of the function.
hook GHook
 

The current GHook.

 The data is owned by the caller of the function.
may_be_in_call gboolean
 

TRUE if hooks which are currently running (e.g. in another thread) are considered valid. If set to FALSE, these are skipped.

Return value

Returns: GHook
 

The next valid GHook, or NULL if none are valid.

 The data is owned by the called function.