Struct gio::SrvTarget

pub struct SrvTarget(_);

SRV (service) records are used by some network protocols to provide service-specific aliasing and load-balancing. For example, XMPP (Jabber) uses SRV records to locate the XMPP server for a domain; rather than connecting directly to "example.com" or assuming a specific server hostname like "xmpp.example.com", an XMPP client would look up the "xmpp-client" SRV record for "example.com", and then connect to whatever host was pointed to by that record.

You can use ResolverExt::lookup_service or ResolverExt::lookup_service_async to find the GSrvTargets for a given service. However, if you are simply planning to connect to the remote service, you can use NetworkService's SocketConnectable interface and not need to worry about SrvTarget at all.

Methods

impl SrvTarget

pub fn new(hostname: &str, port: u16, priority: u16, weight: u16) -> SrvTarget

Creates a new SrvTarget with the given parameters.

You should not need to use this; normally GSrvTargets are created by Resolver.

hostname

the host that the service is running on

port

the port that the service is running on

priority

the target's priority

weight

the target's weight

Returns

a new SrvTarget.

pub fn get_hostname(&mut self) -> Option<GString>

Gets self's hostname (in ASCII form; if you are going to present this to the user, you should use g_hostname_is_ascii_encoded to check if it contains encoded Unicode segments, and use g_hostname_to_unicode to convert it if it does.)

Returns

self's hostname

pub fn get_port(&mut self) -> u16

Gets self's port

Returns

self's port

pub fn get_priority(&mut self) -> u16

Gets self's priority. You should not need to look at this; Resolver already sorts the targets according to the algorithm in RFC 2782.

Returns

self's priority

pub fn get_weight(&mut self) -> u16

Gets self's weight. You should not need to look at this; Resolver already sorts the targets according to the algorithm in RFC 2782.

Returns

self's weight

Trait Implementations

impl Clone for SrvTarget

fn clone(&self) -> SrvTarget

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SrvTarget

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

Formats the value using the given formatter.

impl Eq for SrvTarget

impl Hash for SrvTarget

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

Feeds this value into the given [Hasher].

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

Feeds a slice of this type into the given [Hasher].

impl Ord for SrvTarget

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

This method returns an [Ordering] between self and other.

#[must_use] fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use] fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use] fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<SrvTarget> for SrvTarget

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<SrvTarget> for SrvTarget

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

This method returns an ordering between self and other values if one exists.

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

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

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

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

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

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

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

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

impl StaticType for SrvTarget

fn static_type() -> Type

Returns the type identifier of Self.

impl StructuralEq for SrvTarget

impl StructuralPartialEq for SrvTarget