Gio.SocketAddress

g GObject.GInterface GObject.GInterface Gio.SocketConnectable Gio.SocketConnectable GObject.GInterface->Gio.SocketConnectable GObject.Object GObject.Object Gio.SocketAddress Gio.SocketAddress GObject.Object->Gio.SocketAddress Gio.SocketConnectable->Gio.SocketAddress

Subclasses:

Gio.InetSocketAddress, Gio.NativeSocketAddress, Gio.UnixSocketAddress

Methods

Inherited:

GObject.Object (37), Gio.SocketConnectable (3)

Structs:

GObject.ObjectClass (5)

class

new_from_native (native, len)

get_family ()

get_native_size ()

to_native (dest, destlen)

Virtual Methods

Inherited:

GObject.Object (7), Gio.SocketConnectable (3)

do_get_family ()

do_get_native_size ()

do_to_native (dest, destlen)

Properties

Name

Type

Flags

Short Description

family

Gio.SocketFamily

r

The family of the socket address

Signals

Inherited:

GObject.Object (1)

Fields

Inherited:

GObject.Object (1)

Name

Type

Access

Description

parent_instance

GObject.Object

r

Class Details

class Gio.SocketAddress(**kwargs)
Bases:

GObject.Object, Gio.SocketConnectable

Abstract:

Yes

Structure:

Gio.SocketAddressClass

Gio.SocketAddress is the equivalent of struct sockaddr in the BSD sockets API. This is an abstract class; use Gio.InetSocketAddress for internet sockets, or Gio.UnixSocketAddress for UNIX domain sockets.

classmethod new_from_native(native, len)[source]
Parameters:
  • native (object) – a pointer to a struct sockaddr

  • len (int) – the size of the memory location pointed to by native

Returns:

a new Gio.SocketAddress if native could successfully be converted, otherwise None

Return type:

Gio.SocketAddress

Creates a Gio.SocketAddress subclass corresponding to the native struct sockaddr native.

New in version 2.22.

get_family()[source]
Returns:

the socket family type of self

Return type:

Gio.SocketFamily

Gets the socket family type of self.

New in version 2.22.

get_native_size()[source]
Returns:

the size of the native struct sockaddr that self represents

Return type:

int

Gets the size of self's native struct sockaddr. You can use this to allocate memory to pass to Gio.SocketAddress.to_native().

New in version 2.22.

to_native(dest, destlen)[source]
Parameters:
Raises:

GLib.Error

Returns:

True if dest was filled in, False on error

Return type:

bool

Converts a Gio.SocketAddress to a native struct sockaddr, which can be passed to low-level functions like connect() or bind().

If not enough space is available, a Gio.IOErrorEnum.NO_SPACE error is returned. If the address type is not known on the system then a Gio.IOErrorEnum.NOT_SUPPORTED error is returned.

New in version 2.22.

do_get_family() virtual
Returns:

the socket family type of address

Return type:

Gio.SocketFamily

Gets the socket family type of address.

New in version 2.22.

do_get_native_size() virtual
Returns:

the size of the native struct sockaddr that address represents

Return type:

int

Gets the size of address's native struct sockaddr. You can use this to allocate memory to pass to Gio.SocketAddress.to_native().

New in version 2.22.

do_to_native(dest, destlen) virtual
Parameters:
Returns:

True if dest was filled in, False on error

Return type:

bool

Converts a Gio.SocketAddress to a native struct sockaddr, which can be passed to low-level functions like connect() or bind().

If not enough space is available, a Gio.IOErrorEnum.NO_SPACE error is returned. If the address type is not known on the system then a Gio.IOErrorEnum.NOT_SUPPORTED error is returned.

New in version 2.22.

Property Details

Gio.SocketAddress.props.family
Name:

family

Type:

Gio.SocketFamily

Default Value:

Gio.SocketFamily.INVALID

Flags:

READABLE

The family of the socket address