Enum Protocol

pub enum Protocol<'a> {
    Dns4(Cow<'a, str>),
    Dns6(Cow<'a, str>),
    Ip4(Ipv4Addr),
    Ip6(Ipv6Addr),
    P2P(Cow<'a, [u8]>),
    Tcp(u16),
    Tls(Cow<'a, str>),
    Ws,
    Wss,
    Memory(u64),
    Onion3(Onion3Addr<'a>),
}

Protocol describes all possible multiaddress protocols.

Variants

Dns4(Cow<'a, str>)

Dns6(Cow<'a, str>)

Ip4(Ipv4Addr)

Ip6(Ipv6Addr)

P2P(Cow<'a, [u8]>)

Tcp(u16)

Tls(Cow<'a, str>)

Ws

Wss

Memory(u64)

Contains the “port” to contact. Similar to TCP or UDP, 0 means “assign me a port”.

Onion3(Onion3Addr<'a>)

Implementations

impl<'a> Protocol<'a>

pub fn from_str_peek<T>(iter: T) -> Result<Self, Error>

where T: Iterator<Item = &'a str>,

Parse a protocol value from the given iterator of string slices.

The parsing only consumes the minimum amount of string slices necessary to produce a well-formed protocol. The same iterator can thus be used to parse a sequence of protocols in succession. It is up to client code to check that iteration has finished whenever appropriate.

pub fn from_bytes(input: &'a [u8]) -> Result<(Self, &'a [u8]), Error>

Parse a single Protocol value from its byte slice representation, returning the protocol as well as the remaining byte slice.

pub fn write_to_bytes<W: BufMut>(&self, w: &mut W)

Encode this protocol by writing its binary representation into the given BufMut impl.

pub fn acquire<'b>(self) -> Protocol<'b>

Turn this Protocol into one that owns its data, thus being valid for any lifetime.

Trait Implementations

impl<'a> Clone for Protocol<'a>

fn clone(&self) -> Protocol<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Protocol<'a>

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

Formats the value using the given formatter.

impl Display for Protocol<'_>

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

Formats the value using the given formatter.

impl From<IpAddr> for Protocol<'_>

fn from(addr: IpAddr) -> Self

Converts to this type from the input type.

impl From<Ipv4Addr> for Protocol<'_>

fn from(addr: Ipv4Addr) -> Self

Converts to this type from the input type.

impl From<Ipv6Addr> for Protocol<'_>

fn from(addr: Ipv6Addr) -> Self

Converts to this type from the input type.

impl<'a> From<Protocol<'a>> for Multiaddr

fn from(p: Protocol<'a>) -> Multiaddr

Converts to this type from the input type.

impl<'a> FromIterator<Protocol<'a>> for Multiaddr

fn from_iter<T>(iter: T) -> Self

where T: IntoIterator<Item = Protocol<'a>>,

Creates a value from an iterator.

impl<'a> PartialEq for Protocol<'a>

fn eq(&self, other: &Protocol<'a>) -> 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<'a> Eq for Protocol<'a>

impl<'a> StructuralPartialEq for Protocol<'a>