GNetworkAddress

typedef struct _GNetworkAddress GNetworkAddress;

A GSocketConnectable for resolving a hostname and connecting to that host.

g_network_address_new ()

GSocketConnectable * g_network_address_new              (const gchar *hostname,
                                                         guint16 port);

Creates a new GSocketConnectable for connecting to the given hostname and port.

Since 2.22

g_network_address_get_hostname ()

const gchar *       g_network_address_get_hostname      (GNetworkAddress *addr);

Gets addr's hostname. This might be either UTF-8 or ASCII-encoded, depending on what addr was created with.

Since 2.22

g_network_address_get_port ()

guint16             g_network_address_get_port          (GNetworkAddress *addr);

Gets addr's port number

Since 2.22

g_network_address_get_scheme ()

const gchar *       g_network_address_get_scheme        (GNetworkAddress *addr);

Gets addr's scheme

Since 2.26

g_network_address_parse ()

GSocketConnectable * g_network_address_parse            (const gchar *host_and_port,
                                                         guint16 default_port,
                                                         GError **error);

Creates a new GSocketConnectable for connecting to the given hostname and port. May fail and return NULL in case parsing host_and_port fails.

host_and_port may be in any of a number of recognised formats; an IPv6 address, an IPv4 address, or a domain name (in which case a DNS lookup is performed). Quoting with [] is supported for all address types. A port override may be specified in the usual way with a colon.

If no port is specified in host_and_port then default_port will be used as the port number to connect to.

In general, host_and_port is expected to be provided by the user (allowing them to give the hostname, and a port overide if necessary) and default_port is expected to be provided by the application.

(The port component of host_and_port can also be specified as a service name rather than as a numeric port, but this functionality is deprecated, because it depends on the contents of /etc/services, which is generally quite sparse on platforms other than Linux.)

Since 2.22

g_network_address_parse_uri ()

GSocketConnectable * g_network_address_parse_uri        (const gchar *uri,
                                                         guint16 default_port,
                                                         GError **error);

Creates a new GSocketConnectable for connecting to the given uri. May fail and return NULL in case parsing uri fails.

Using this rather than g_network_address_new() or g_network_address_parse() allows GSocketClient to determine when to use application-specific proxy protocols.

Since 2.26

The "hostname" property

  "hostname"                 gchar*                : Read / Write / Construct Only

Hostname to resolve.

Default value: NULL

The "port" property

  "port"                     guint                 : Read / Write / Construct Only

Network port.

Allowed values: <= 65535

Default value: 0

The "scheme" property

  "scheme"                   gchar*                : Read / Write / Construct Only

URI Scheme.

Default value: NULL