Skip to main content

Sampler

Struct Sampler 

Source
pub struct Sampler { /* private fields */ }
Expand description

Measures download and upload between samples. Owned by the caller: two samplers never disturb each other. sample never blocks and allocates nothing.

use std::time::Duration;

let mut net = sys_lib::net::Sampler::new()?;
loop {
    std::thread::sleep(Duration::from_secs(5));
    let t = net.sample()?;
    println!("down {} up {}", t.download, t.upload);
    for i in net.sample_per_interface()? {
        println!("  {}: down {} up {}", i.interface, i.traffic.download, i.traffic.upload);
    }
}

Implementations§

Source§

impl Sampler

Source

pub fn new() -> Result<Sampler>

Takes the first reading, of the totals and of each interface.

§Errors

As totals.

Source

pub fn sample(&mut self) -> Result<Traffic>

Download and upload since the previous sample, every interface but loopback. A counter that went backwards re-bases the sampler and reads as no traffic for that interval.

§Errors

TooSoon when no time passed since the previous sample.

Source

pub fn sample_per_interface(&mut self) -> Result<Vec<InterfaceTraffic>>

Traffic since the previous per-interface sample, for each interface (allocates the Vec). An interface seen for the first time reads as no traffic.

§Errors

TooSoon when no time passed since the previous sample.

Trait Implementations§

Source§

impl Debug for Sampler

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.