Socket.connect

Connect the socket to the specified remote address.

For connection oriented socket this generally means we attempt to make a connection to the address. For a connection-less socket it sets the default address for Socket.send and discards all incoming datagrams from other sources.

Generally connection oriented sockets can only connect once, but connection-less sockets can connect multiple times to change the default address.

If the connect call needs to do network I/O it will block, unless non-blocking I/O is enabled. Then G_IO_ERROR_PENDING is returned and the user can be notified of the connection finishing by waiting for the G_IO_OUT condition. The result of the connection must then be checked with Socket.checkConnectResult.

class Socket
bool
connect

Parameters

address SocketAddress

a gio.SocketAddress specifying the remote address.

cancellable Cancellable

a GCancellable or NULL

Return Value

Type: bool

TRUE if connected, FALSE on error.

Throws

GException on failure.

Meta

Since

2.22