Method

GioCancellablesource_new

since: 2.28

Declaration

GSource*
g_cancellable_source_new (
  GCancellable* cancellable
)

Description

Creates a source that triggers if cancellable is cancelled and calls its callback of type GCancellableSourceFunc. This is primarily useful for attaching to another (non-cancellable) source with g_source_add_child_source() to add cancellability to it.

For convenience, you can call this with a NULL GCancellable, in which case the source will never trigger.

The new GSource will hold a reference to the GCancellable.

Available since: 2.28

Return value

Type: GSource

The new GSource.

The caller of the method takes ownership of the data, and is responsible for freeing it.