Declaration [src]

purple_signal_emit_vargs_return_1 (
  void* instance,
  const char* signal,
  va_list args

Description [src]

Emits a signal and returns the first non-NULL return value.

Further signal handlers are NOT called after a handler returns something other than NULL.

This function is not directly available to language bindings


instance void*

The instance emitting the signal.

 The argument can be NULL.
 The data is owned by the caller of the function.
signal const char*

The signal being emitted.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
args va_list

The arguments list.

Return value

Returns: void*

The first non-NULL return value.

 The data is owned by the called function.
 The return value can be NULL.