Socket.createSource

Creates a glib.Source that can be attached to a GMainContext to monitor for the availability of the specified condition on the socket. The glib.Source keeps a reference to the socket.

The callback on the source is of the GSocketSourceFunc type.

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

cancellable if not NULL 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 Cancellable.isCancelled.

If socket has a timeout set, and it is reached before condition occurs, the source will then trigger anyway, reporting G_IO_IN or G_IO_OUT depending on condition. However, socket will have been marked as having had a timeout, and so the next atk.Socket I/O method you call will then fail with a G_IO_ERROR_TIMED_OUT.

Parameters

condition GIOCondition

a GIOCondition mask to monitor

cancellable Cancellable

a GCancellable or NULL

Return Value

Type: Source

a newly allocated GSource, free with Source.unref.

Meta

Since

2.22