Struct libp2p_kad::QueryStats

pub struct QueryStats { /* private fields */ }

Execution statistics of a query.

Implementations

impl QueryStats

pub fn empty() -> Self

pub fn num_requests(&self) -> u32

Gets the total number of requests initiated by the query.

pub fn num_successes(&self) -> u32

Gets the number of successful requests.

pub fn num_failures(&self) -> u32

Gets the number of failed requests.

pub fn num_pending(&self) -> u32

Gets the number of pending requests.

Note: A query can finish while still having pending requests, if the termination conditions are already met.

pub fn duration(&self) -> Option<Duration>

Gets the duration of the query.

If the query has not yet finished, the duration is measured from the start of the query to the current instant.

If the query did not yet start (i.e. yield the first peer to contact), None is returned.

pub fn merge(self, other: QueryStats) -> Self

Merges these stats with the given stats of another query, e.g. to accumulate statistics from a multi-phase query.

Counters are merged cumulatively while the instants for start and end of the queries are taken as the minimum and maximum, respectively.

Trait Implementations

impl Clone for QueryStats

fn clone(&self) -> QueryStats

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for QueryStats

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

Formats the value using the given formatter.

impl PartialEq<QueryStats> for QueryStats

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

impl StructuralEq for QueryStats

impl StructuralPartialEq for QueryStats