Function

Purplesignal_connect_priority_vargs

Declaration [src]

gulong
purple_signal_connect_priority_vargs (
  void* instance,
  const char* signal,
  void* handle,
  GCallback func,
  void* data,
  int priority
)

Description [src]

Connects a signal handler to a signal for a particular object.

The signal handler will take a va_args of arguments, instead of individual arguments.

Take care not to register a handler function twice. Purple will not correct any mistakes for you in this area.

See purple_signal_disconnect()

Parameters

`instance`	`void*`
	The instance to connect to.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`signal`	`const char*`
	The name of the signal to connect.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`handle`	`void*`
	The handle of the receiver.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`func`	`GCallback`
	The callback function.
`data`	`void*`
	The data to pass to the callback function.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`priority`	`int`
	The priority with which the handler should be called. Signal handlers are called in ascending numerical order of `priority` from #PURPLE_SIGNAL_PRIORITY_LOWEST to #PURPLE_SIGNAL_PRIORITY_HIGHEST.

Return value

Returns:	`gulong`
	The signal handler ID.