![]() |
![]() |
![]() |
GIO Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
#include <gio/gio.h> GNetworkAddress; GSocketConnectable * g_network_address_new (const gchar *hostname
,guint16 port
); const gchar * g_network_address_get_hostname (GNetworkAddress *addr
); guint16 g_network_address_get_port (GNetworkAddress *addr
); GSocketConnectable * g_network_address_parse (const gchar *host_and_port
,guint16 default_port
,GError **error
);
"hostname" gchar* : Read / Write / Construct Only "port" guint : Read / Write / Construct Only
GNetworkAddress provides an easy way to resolve a hostname and then attempt to connect to that host, handling the possibility of multiple IP addresses and multiple address families.
See GSocketConnectable for and example of using the connectable interface.
typedef struct _GNetworkAddress GNetworkAddress;
A GSocketConnectable for resolving a hostname and connecting to that host.
GSocketConnectable * g_network_address_new (const gchar *hostname
,guint16 port
);
Creates a new GSocketConnectable for connecting to the given
hostname
and port
.
|
the hostname |
|
the port |
Returns : |
the new GNetworkAddress |
Since 2.22
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.
|
a GNetworkAddress |
Returns : |
addr 's hostname
|
Since 2.22
guint16 g_network_address_get_port (GNetworkAddress *addr
);
Gets addr
's port number
|
a GNetworkAddress |
Returns : |
addr 's port (which may be 0)
|
Since 2.22
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. Ports may be given as decimal numbers or symbolic names (in
which case an /etc/services lookup is performed).
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 hostname and optionally a port |
|
the default port if not in host_and_port
|
|
a pointer to a GError, or NULL
|
Returns : |
the new GNetworkAddress, or NULL on error
|
Since 2.22