Struct tentacle_multiaddr::Multiaddr

source · [−]

pub struct Multiaddr { /* private fields */ }

Expand description

Representation of a Multiaddr.

Implementations

source

impl Multiaddr

source

pub fn is_empty(&self) -> bool

Returns true if the multiaddres has no data.

source

pub fn len(&self) -> usize

Return the length in bytes of this multiaddress.

source

pub fn to_vec(&self) -> Vec<u8>

Return a copy of this Multiaddr’s byte representation.

source

pub fn push(&mut self, p: Protocol<'_>)

Adds an already-parsed address component to the end of this multiaddr.

Examples

use tentacle_multiaddr::{Multiaddr, Protocol};

let mut address: Multiaddr = "/ip4/127.0.0.1".parse().unwrap();
address.push(Protocol::Tcp(10000));
println!("{}", address);
assert_eq!(address, "/ip4/127.0.0.1/tcp/10000".parse().unwrap());

source

pub fn pop<'a>(&mut self) -> Option<Protocol<'a>>

Pops the last Protocol of this multiaddr, or None if the multiaddr is empty.

use std::net::Ipv4Addr;
use tentacle_multiaddr::{Multiaddr, Protocol};

let mut address: Multiaddr = "/ip4/127.0.0.1/tcp/5678".parse().unwrap();

assert_eq!(address.pop().unwrap(), Protocol::Tcp(5678));
assert_eq!(address.pop().unwrap(), Protocol::Ip4(Ipv4Addr::new(127, 0, 0, 1)));

source

pub fn iter(&self) -> Iter<'_>ⓘNotable traits for Iter<'a>`impl<'a> Iterator for Iter<'a> type Item = Protocol<'a>;`

Returns the components of this multiaddress.

use std::net::Ipv4Addr;
use tentacle_multiaddr::{Multiaddr, Protocol};

let address: Multiaddr = "/ip4/127.0.0.1/tcp/5678".parse().unwrap();

let components = address.iter().collect::<Vec<_>>();
assert_eq!(components[0], Protocol::Ip4(Ipv4Addr::new(127, 0, 0, 1)));
assert_eq!(components[1], Protocol::Tcp(5678));

source

pub fn replace<'a, F>(&self, at: usize, by: F) -> Option<Multiaddr> where
F: FnOnce(&Protocol<'_>) -> Option<Protocol<'a>>,

Replace a Protocol at some position in this Multiaddr.

The parameter at denotes the index of the protocol at which the function by will be applied to the current protocol, returning an optional replacement.

If at is out of bounds or by does not yield a replacement value, None will be returned. Otherwise a copy of this Multiaddr with the updated Protocol at position at will be returned.

Trait Implementations

source

impl AsRef<[u8]> for Multiaddr

source

fn as_ref(&self) -> &[u8]ⓘNotable traits for &mut [u8]`impl<'_> Write for &mut [u8]impl<'_> Read for &[u8]`

Converts this type into a shared reference of the (usually inferred) input type.

source

impl Clone for Multiaddr

source

fn clone(&self) -> Multiaddr

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

impl Debug for Multiaddr

source

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

Formats the value using the given formatter. Read more

source

impl<'de> Deserialize<'de> for Multiaddr

source

fn deserialize<D>(deserializer: D) -> StdResult<Self, D::Error> where
D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

source

impl Display for Multiaddr

source

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

Convert a Multiaddr to a string

Examples

use tentacle_multiaddr::Multiaddr;

let address: Multiaddr = "/ip4/127.0.0.1/tcp/80".parse().unwrap();
assert_eq!(address.to_string(), "/ip4/127.0.0.1/tcp/80");