Gio.InetAddress

g GObject.Object GObject.Object Gio.InetAddress Gio.InetAddress GObject.Object->Gio.InetAddress

Subclasses:

None

Methods

Inherited:

GObject.Object (37)

Structs:

GObject.ObjectClass (5)

class

new_any (family)

class

new_from_bytes (bytes, family)

class

new_from_string (string)

class

new_loopback (family)

equal (other_address)

get_family ()

get_is_any ()

get_is_link_local ()

get_is_loopback ()

get_is_mc_global ()

get_is_mc_link_local ()

get_is_mc_node_local ()

get_is_mc_org_local ()

get_is_mc_site_local ()

get_is_multicast ()

get_is_site_local ()

get_native_size ()

to_string ()

Virtual Methods

Inherited:

GObject.Object (7)

do_to_string ()

Properties

Name

Type

Flags

Short Description

bytes

int

r/w/co

The raw address data

family

Gio.SocketFamily

r/w/co

The address family (IPv4 or IPv6)

is-any

bool

r

Whether this is the “any” address for its family

is-link-local

bool

r

Whether this is a link-local address

is-loopback

bool

r

Whether this is the loopback address for its family

is-mc-global

bool

r

Whether this is a global multicast address

is-mc-link-local

bool

r

Whether this is a link-local multicast address

is-mc-node-local

bool

r

Whether this is a node-local multicast address

is-mc-org-local

bool

r

Whether this is an organization-local multicast address

is-mc-site-local

bool

r

Whether this is a site-local multicast address

is-multicast

bool

r

Whether this is a multicast address

is-site-local

bool

r

Whether this is a site-local address

Signals

Inherited:

GObject.Object (1)

Fields

Inherited:

GObject.Object (1)

Name

Type

Access

Description

parent_instance

GObject.Object

r

Class Details

class Gio.InetAddress(**kwargs)
Bases:

GObject.Object

Abstract:

No

Structure:

Gio.InetAddressClass

Gio.InetAddress represents an IPv4 or IPv6 internet address. Use Gio.Resolver.lookup_by_name() or Gio.Resolver.lookup_by_name_async() to look up the Gio.InetAddress for a hostname. Use Gio.Resolver.lookup_by_address() or Gio.Resolver.lookup_by_address_async() to look up the hostname for a Gio.InetAddress.

To actually connect to a remote host, you will need a Gio.InetSocketAddress (which includes a Gio.InetAddress as well as a port number).

classmethod new_any(family)[source]
Parameters:

family (Gio.SocketFamily) – the address family

Returns:

a new Gio.InetAddress corresponding to the “any” address for family. Free the returned object with GObject.Object.unref().

Return type:

Gio.InetAddress

Creates a Gio.InetAddress for the “any” address (unassigned/”don’t care”) for family.

New in version 2.22.

classmethod new_from_bytes(bytes, family)[source]
Parameters:
Returns:

a new Gio.InetAddress corresponding to family and bytes. Free the returned object with GObject.Object.unref().

Return type:

Gio.InetAddress

Creates a new Gio.InetAddress from the given family and bytes. bytes should be 4 bytes for Gio.SocketFamily.IPV4 and 16 bytes for Gio.SocketFamily.IPV6.

New in version 2.22.

classmethod new_from_string(string)[source]
Parameters:

string (str) – a string representation of an IP address

Returns:

a new Gio.InetAddress corresponding to string, or None if string could not be parsed. Free the returned object with GObject.Object.unref().

Return type:

Gio.InetAddress or None

Parses string as an IP address and creates a new Gio.InetAddress.

New in version 2.22.

classmethod new_loopback(family)[source]
Parameters:

family (Gio.SocketFamily) – the address family

Returns:

a new Gio.InetAddress corresponding to the loopback address for family. Free the returned object with GObject.Object.unref().

Return type:

Gio.InetAddress

Creates a Gio.InetAddress for the loopback address for family.

New in version 2.22.

equal(other_address)[source]
Parameters:

other_address (Gio.InetAddress) – Another Gio.InetAddress.

Returns:

True if self and other_address are equal, False otherwise.

Return type:

bool

Checks if two Gio.InetAddress instances are equal, e.g. the same address.

New in version 2.30.

get_family()[source]
Returns:

self's family

Return type:

Gio.SocketFamily

Gets self's family

New in version 2.22.

get_is_any()[source]
Returns:

True if self is the “any” address for its family.

Return type:

bool

Tests whether self is the “any” address for its family.

New in version 2.22.

Returns:

True if self is a link-local address.

Return type:

bool

Tests whether self is a link-local address (that is, if it identifies a host on a local network that is not connected to the Internet).

New in version 2.22.

get_is_loopback()[source]
Returns:

True if self is the loopback address for its family.

Return type:

bool

Tests whether self is the loopback address for its family.

New in version 2.22.

get_is_mc_global()[source]
Returns:

True if self is a global multicast address.

Return type:

bool

Tests whether self is a global multicast address.

New in version 2.22.

Returns:

True if self is a link-local multicast address.

Return type:

bool

Tests whether self is a link-local multicast address.

New in version 2.22.

get_is_mc_node_local()[source]
Returns:

True if self is a node-local multicast address.

Return type:

bool

Tests whether self is a node-local multicast address.

New in version 2.22.

get_is_mc_org_local()[source]
Returns:

True if self is an organization-local multicast address.

Return type:

bool

Tests whether self is an organization-local multicast address.

New in version 2.22.

get_is_mc_site_local()[source]
Returns:

True if self is a site-local multicast address.

Return type:

bool

Tests whether self is a site-local multicast address.

New in version 2.22.

get_is_multicast()[source]
Returns:

True if self is a multicast address.

Return type:

bool

Tests whether self is a multicast address.

New in version 2.22.

get_is_site_local()[source]
Returns:

True if self is a site-local address.

Return type:

bool

Tests whether self is a site-local address such as 10.0.0.1 (that is, the address identifies a host on a local network that can not be reached directly from the Internet, but which may have outgoing Internet connectivity via a NAT or firewall).

New in version 2.22.

get_native_size()[source]
Returns:

the number of bytes used for the native version of self.

Return type:

int

Gets the size of the native raw binary address for self. This is the size of the data that you get from g_inet_address_to_bytes().

New in version 2.22.

to_string()[source]
Returns:

a representation of self as a string, which should be freed after use.

Return type:

str

Converts self to string form.

New in version 2.22.

do_to_string() virtual
Returns:

a representation of address as a string, which should be freed after use.

Return type:

str

Converts address to string form.

New in version 2.22.

Property Details

Gio.InetAddress.props.bytes
Name:

bytes

Type:

int

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT_ONLY

The raw address data

Gio.InetAddress.props.family
Name:

family

Type:

Gio.SocketFamily

Default Value:

Gio.SocketFamily.INVALID

Flags:

READABLE, WRITABLE, CONSTRUCT_ONLY

The address family (IPv4 or IPv6)

Gio.InetAddress.props.is_any
Name:

is-any

Type:

bool

Default Value:

False

Flags:

READABLE

Whether this is the “any” address for its family. See Gio.InetAddress.get_is_any().

New in version 2.22.

Name:

is-link-local

Type:

bool

Default Value:

False

Flags:

READABLE

Whether this is a link-local address. See Gio.InetAddress.get_is_link_local().

New in version 2.22.

Gio.InetAddress.props.is_loopback
Name:

is-loopback

Type:

bool

Default Value:

False

Flags:

READABLE

Whether this is the loopback address for its family. See Gio.InetAddress.get_is_loopback().

New in version 2.22.

Gio.InetAddress.props.is_mc_global
Name:

is-mc-global

Type:

bool

Default Value:

False

Flags:

READABLE

Whether this is a global multicast address. See Gio.InetAddress.get_is_mc_global().

New in version 2.22.

Name:

is-mc-link-local

Type:

bool

Default Value:

False

Flags:

READABLE

Whether this is a link-local multicast address. See Gio.InetAddress.get_is_mc_link_local().

New in version 2.22.

Gio.InetAddress.props.is_mc_node_local
Name:

is-mc-node-local

Type:

bool

Default Value:

False

Flags:

READABLE

Whether this is a node-local multicast address. See Gio.InetAddress.get_is_mc_node_local().

New in version 2.22.

Gio.InetAddress.props.is_mc_org_local
Name:

is-mc-org-local

Type:

bool

Default Value:

False

Flags:

READABLE

Whether this is an organization-local multicast address. See Gio.InetAddress.get_is_mc_org_local().

New in version 2.22.

Gio.InetAddress.props.is_mc_site_local
Name:

is-mc-site-local

Type:

bool

Default Value:

False

Flags:

READABLE

Whether this is a site-local multicast address. See Gio.InetAddress.get_is_mc_site_local().

New in version 2.22.

Gio.InetAddress.props.is_multicast
Name:

is-multicast

Type:

bool

Default Value:

False

Flags:

READABLE

Whether this is a multicast address. See Gio.InetAddress.get_is_multicast().

New in version 2.22.

Gio.InetAddress.props.is_site_local
Name:

is-site-local

Type:

bool

Default Value:

False

Flags:

READABLE

Whether this is a site-local address. See Gio.InetAddress.get_is_loopback().

New in version 2.22.