Struct gio::NetworkAddress

pub struct NetworkAddress { /* private fields */ }

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.

The enumeration results of resolved addresses may be cached as long as this object is kept alive which may have unexpected results if alive for too long.

See SocketConnectable for an example of using the connectable interface.

Properties

hostname

Hostname to resolve.

Readable | Writeable | Construct Only

port

Network port.

Readable | Writeable | Construct Only

scheme

URI scheme.

Readable | Writeable | Construct Only

Implements

NetworkAddressExt, [trait@glib::ObjectExt], SocketConnectableExt

GLib type: GObject with reference counted clone semantics.

Implementations

impl NetworkAddress

pub const NONE: Option<&'static NetworkAddress> = None

pub fn new(hostname: &str, port: u16) -> NetworkAddress

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

Note that depending on the configuration of the machine, a @hostname of localhost may refer to the IPv4 loopback address only, or to both IPv4 and IPv6; use g_network_address_new_loopback() to create a #GNetworkAddress that is guaranteed to resolve to both addresses.

hostname

the hostname

port

the port

Returns

the new #GNetworkAddress

pub fn new_loopback(port: u16) -> NetworkAddress

Creates a new #GSocketConnectable for connecting to the local host over a loopback connection to the given @port. This is intended for use in connecting to local services which may be running on IPv4 or IPv6.

The connectable will return IPv4 and IPv6 loopback addresses, regardless of how the host resolves localhost. By contrast, g_network_address_new() will often only return an IPv4 address when resolving localhost, and an IPv6 address for localhost6.

g_network_address_get_hostname() will always return localhost for a #GNetworkAddress created with this constructor.

port

the port

Returns

the new #GNetworkAddress

pub fn parse( host_and_port: &str, default_port: u16, ) -> Result<NetworkAddress, Error>

Creates a new #GSocketConnectable for connecting to the given @hostname and @port. May fail and return None 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 override 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.)

host_and_port

the hostname and optionally a port

default_port

the default port if not in @host_and_port

Returns

the new #GNetworkAddress, or None on error

pub fn parse_uri(uri: &str, default_port: u16) -> Result<NetworkAddress, Error>

Creates a new #GSocketConnectable for connecting to the given @uri. May fail and return None 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.

uri

the hostname and optionally a port

default_port

The default port if none is found in the URI

Returns

the new #GNetworkAddress, or None on error

Trait Implementations

impl Clone for NetworkAddress

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NetworkAddress

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasParamSpec for NetworkAddress

type ParamSpec = ParamSpecObject

type SetValue = NetworkAddress

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, NetworkAddress>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for NetworkAddress

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes the memory address of this object.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for NetworkAddress

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl ParentClassIs for NetworkAddress

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for NetworkAddress

fn eq(&self, other: &OT) -> bool

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for NetworkAddress

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for NetworkAddress

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for NetworkAddress

impl IsA<SocketConnectable> for NetworkAddress

impl Send for NetworkAddress

impl Sync for NetworkAddress