Struct SrvTarget

pub struct SrvTarget { /* private fields */ }

A single target host/port that a network service is running on.

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 GSrvTarget at all.

GLib type: Boxed type with copy-on-clone semantics.

Implementations

impl SrvTarget

pub fn as_ptr(&self) -> *mut GSrvTarget

Return the inner pointer to the underlying C value.

pub unsafe fn from_glib_ptr_borrow(ptr: &*mut GSrvTarget) -> &Self

Borrows the underlying C value.

pub unsafe fn from_glib_ptr_borrow_mut(ptr: &mut *mut GSrvTarget) -> &mut Self

Borrows the underlying C value mutably.

impl SrvTarget

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

Creates a new #GSrvTarget with the given parameters.

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

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 #GSrvTarget.

pub fn hostname(&mut self) -> 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 port(&mut self) -> u16

Gets @self’s port

Returns

@self’s port

pub fn priority(&mut self) -> u16

Gets @self’s priority. You should not need to look at this; #GResolver already sorts the targets according to the algorithm in RFC 2782.

Returns

@self’s priority

pub fn weight(&mut self) -> u16

Gets @self’s weight. You should not need to look at this; #GResolver already sorts the targets according to the algorithm in RFC 2782.

Returns

@self’s weight

Trait Implementations

impl Clone for SrvTarget

fn clone(&self) -> Self

Copies the boxed type with the type-specific copy function.

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 From<SrvTarget> for Value

fn from(o: SrvTarget) -> Self

Converts to this type from the input type.

impl HasParamSpec for SrvTarget

type ParamSpec = ParamSpecBoxed

type SetValue = SrvTarget

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

type BuilderFn = fn(_: &str) -> ParamSpecBoxedBuilder<'_, SrvTarget>

fn param_spec_builder() -> Self::BuilderFn

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, Self: Sized,

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.

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,

Restrict a value to a certain interval.

impl PartialEq for SrvTarget

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd 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: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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 Eq for SrvTarget

impl StructuralPartialEq for SrvTarget