SocketConnection

Object Hierarchy:

Description:

[ CCode ( type_id = "g_socket_connection_get_type ()" ) ]
[ Version ( since = "2.22" ) ]
public class SocketConnection : IOStream

`GSocketConnection` is a [class@Gio.

IOStream] for a connected socket. They can be created either by [class@Gio.SocketClient] when connecting to a host, or by [ class@Gio.SocketListener] when accepting a new client.

The type of the `GSocketConnection` object returned from these calls depends on the type of the underlying socket that is in use. For instance, for a TCP/IP connection it will be a [class@Gio.TcpConnection].

Choosing what type of object to construct is done with the socket connection factory, and it is possible for third parties to register custom socket connection types for specific combination of socket family/type/protocol using [func@Gio.SocketConnection.factory_register_type].

To close a `GSocketConnection`, use [method@Gio.IOStream.close]. Closing both substreams of the [class@Gio.IOStream] separately will not close the underlying [class@Gio.Socket].

All known sub-classes:

TcpConnection

TcpWrapperConnection

Namespace: GLib

Package: gio-2.0

Content:

Properties:

public Socket socket { get; construct; }
The underlying [class@Gio.

Static methods:

public static SocketConnection factory_create_connection (Socket socket)
Creates a SocketConnection subclass of the right type for this.
public static Type factory_lookup_type (SocketFamily family, SocketType type, int protocol_id)
Looks up the Type to be used when creating socket connections on sockets with the specified family, type and protocol_id.
public static void factory_register_type (Type g_type, SocketFamily family, SocketType type, int protocol)
Looks up the Type to be used when creating socket connections on sockets with the specified family, type and protocol.

Creation methods:

protected SocketConnection ()

Methods:

public bool connect (SocketAddress address, Cancellable? cancellable = null) throws Error
Connect this to the specified remote address.
public async bool connect_async (SocketAddress address, Cancellable? cancellable = null) throws Error
Asynchronously connect this to the specified remote address.
public SocketAddress get_local_address () throws Error
Try to get the local address of a socket connection.
public SocketAddress get_remote_address () throws Error
Try to get the remote address of a socket connection.
public unowned Socket get_socket ()
Gets the underlying Socket object of the connection.
public bool is_connected ()
Checks if this is connected.

Inherited Members:

All known members inherited from class GLib.IOStream

All known members inherited from class GLib.Object