Struct FullAeAddr

pub struct FullAeAddr<T> { /* private fields */ }

A specification for a full address to the target SCP: an application entity title, plus a generic address, typically a socket address.

These addresses can be serialized and parsed with the syntax {ae_title}@{address}, where the socket address is parsed according to the expectations of the parameter type T.

For the version of the struct without a mandatory AE title, see AeAddr.

Example

let addr: FullAeAddr<String> = "SCP-STORAGE@127.0.0.1:104".parse()?;
assert_eq!(addr.ae_title(), "SCP-STORAGE");
assert_eq!(addr.socket_addr(), "127.0.0.1:104");
let addr: FullAeAddr<SocketAddr> = "SCP-STORAGE@127.0.0.1:104".parse()?;
assert_eq!(addr.ae_title(), "SCP-STORAGE");
assert_eq!(addr.socket_addr(), &SocketAddr::from(([127, 0, 0, 1], 104)));
assert_eq!(&addr.to_string(), "SCP-STORAGE@127.0.0.1:104");

Implementations

impl<T> FullAeAddr<T>

pub fn new(ae_title: impl Into<String>, socket_addr: T) -> Self

Create an AE address from its bare constituent parts.

pub fn ae_title(&self) -> &str

Retrieve the application entity title portion.

pub fn socket_addr(&self) -> &T

Retrieve the network address portion.

pub fn into_parts(self) -> (String, T)

Convert the full address into its constituent parts.

Trait Implementations

impl<T: Clone> Clone for FullAeAddr<T>

fn clone(&self) -> FullAeAddr<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for FullAeAddr<T>

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

Formats the value using the given formatter.

impl<T> Display for FullAeAddr<T>

where T: Display,

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

Formats the value using the given formatter.

impl<T> From<(String, T)> for FullAeAddr<T>

fn from((ae_title, socket_addr): (String, T)) -> Self

Converts to this type from the input type.

impl<T> From<FullAeAddr<T>> for AeAddr<T>

fn from(full: FullAeAddr<T>) -> Self

Converts to this type from the input type.

impl<T> FromStr for FullAeAddr<T>

where T: FromStr, T::Err: Debug + AsErrorSource,

type Err = ParseAeAddressError<<T as FromStr>::Err>

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl<T: Hash> Hash for FullAeAddr<T>

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<T: PartialEq> PartialEq for FullAeAddr<T>

fn eq(&self, other: &FullAeAddr<T>) -> 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<T> ToSocketAddrs for FullAeAddr<T>

where T: ToSocketAddrs,

type Iter = <T as ToSocketAddrs>::Iter

Returned iterator over socket addresses which this type may correspond to.

fn to_socket_addrs(&self) -> Result<Self::Iter>

Converts this object to an iterator of resolved SocketAddrs.

impl<T: Eq> Eq for FullAeAddr<T>

impl<T> StructuralPartialEq for FullAeAddr<T>