Gio.DatagramBased.create_source (original) (raw)

Method

GioDatagramBasedcreate_source

since: 2.48

Declaration [src]

GSource*
g_datagram_based_create_source (
  GDatagramBased* datagram_based,
  GIOCondition condition,
  GCancellable* cancellable
)

Description [src]

Creates a GSource that can be attached to a GMainContext to monitor for the availability of the specified condition on the GDatagramBased. TheGSource keeps a reference to the datagram_based.

The callback on the source is of the GDatagramBasedSourceFunc type.

It is meaningless to specify G_IO_ERR or G_IO_HUP in condition; these conditions will always be reported in the callback if they are true.

If non-NULL, cancellable can be used to cancel the source, which will cause the source to trigger, reporting the current condition (which is likely 0 unless cancellation happened at the same time as a condition change). You can check for this in the callback using g_cancellable_is_cancelled().

Available since: 2.48

Parameters

condition

Type: GIOCondition

A GIOCondition mask to monitor.

cancellable

Type: GCancellable

A GCancellable.

Return value

Type: GSource

A newly allocated GSource.

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