Struct torrust_tracker::tracker::peer::Id

pub struct Id(pub [u8; 20]);

Peer ID. A 20-byte array.

A string of length 20 which this downloader uses as its id. Each downloader generates its own id at random at the start of a new download.

A sample peer ID:

use torrust_tracker::tracker::peer;

let peer_id = peer::Id(*b"-qB00000000000000000");

Tuple Fields

0: [u8; 20]

Implementations

impl Id

pub fn from_bytes(bytes: &[u8]) -> Self

Panics

Will panic if byte slice does not contains the exact amount of bytes need for the Id.

pub fn to_bytes(&self) -> [u8; 20]

impl Id

pub fn to_hex_string(&self) -> Option<String>

Converts to hex string.

For the Id -qB00000000000000000 it returns 2d71423030303030303030303030303030303030

For example:

 Bytes                = Hex
 -qB00000000000000000 = 2d71423030303030303030303030303030303030
 -qB00000000000000000 = 2d 71 42 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30

 -------------
 |Char | Hex |
 -------------
 | -   | 2D  |
 | q   | 71  |
 | B   | 42  |
 | 0   | 30  |
 -------------

Return None is some of the bytes are invalid UTF8 values.

Panics

It will panic if the binascii::bin2hex from a too-small output buffer.

pub fn get_client_name(&self) -> Option<&'static str>

Trait Implementations

impl Clone for Id

fn clone(&self) -> Id

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Id

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

Formats the value using the given formatter.

impl Display for Id

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

Formats the value using the given formatter.

impl From<[u8; 20]> for Id

fn from(bytes: [u8; 20]) -> Self

Converts to this type from the input type.

impl From<Id> for Id

fn from(peer_id: Id) -> Self

Converts to this type from the input type.

impl FromStr for Id

type Err = IdConversionError

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 Hash for Id

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 Id

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<Id> for Id

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

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

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

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

impl PartialOrd<Id> for Id

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

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

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

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

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

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

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

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

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

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

impl Serialize for Id

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<Vec<u8, Global>> for Id

type Error = IdConversionError

The type returned in the event of a conversion error.

fn try_from(bytes: Vec<u8>) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Id

impl Eq for Id

impl StructuralEq for Id

impl StructuralPartialEq for Id