Struct measurements::frequency::Frequency

pub struct Frequency { /* private fields */ }

The Frequency struct can be used to deal with frequencies in a common way. Common SI prefixes are supported.

Example

use measurements::Frequency;

let radio_station = Frequency::from_hertz(101.5e6);
println!("Tune to {}.", radio_station);

Implementations

impl Frequency

pub fn from_hertz(hertz: f64) -> Self

Create a new Frequency from a floating point value in hertz

pub fn from_nanohertz(nanohertz: f64) -> Self

Create a new Frequency from a floating point value in Nanohertz.

pub fn from_microhertz(microhertz: f64) -> Self

Create a new Frequency from a floating point value in Microhertz.

pub fn from_millihertz(millihertz: f64) -> Self

Create a new Frequency from a floating point value in Millihertz.

pub fn from_kilohertz(kilohertz: f64) -> Self

Create a new Frequency from a floating point value in Kilohertz (kHz).

pub fn from_megahertz(megahertz: f64) -> Self

Create a new Frequency from a floating point value in Megahertz (MHz).

pub fn from_gigahertz(gigahertz: f64) -> Self

Create a new Frequency from a floating point value in Gigahertz (GHz).

pub fn from_terahertz(terahertz: f64) -> Self

Create a new Frequency from a floating point value in Terahertz (THz).

pub fn from_period(period: Duration) -> Self

Create a new Frequency from a floating point value of the period in seconds.

pub fn as_nanohertz(&self) -> f64

Convert this Frequency to a floating point value in Nanohertz

pub fn as_microhertz(&self) -> f64

Convert this Frequency to a floating point value in Microhertz

pub fn as_millihertz(&self) -> f64

Convert this Frequency to a floating point value in Millihertz

pub fn as_hertz(&self) -> f64

Convert this Frequency to a floating point value in Hertz (Hz)

pub fn as_kilohertz(&self) -> f64

Convert this Frequency to a floating point value in Kilohertz (kHz)

pub fn as_megahertz(&self) -> f64

Convert this Frequency to a floating point value in Megahertz (MHz)

pub fn as_gigahertz(&self) -> f64

Convert this Frequency to a floating point value in gigahertz (GHz)

pub fn as_terahertz(&self) -> f64

Convert this Frequency to a floating point value in terahertz (THz)

pub fn as_period(&self) -> Duration

Convert this Frequency to a floating point value of the period in seconds.

Trait Implementations

impl Add<Frequency> for Frequency

type Output = Self

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self

Performs the + operation.

impl Clone for Frequency

fn clone(&self) -> Frequency

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Frequency

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

Formats the value using the given formatter.

impl Display for Frequency

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

Formats the value using the given formatter.

impl Div<Frequency> for Frequency

type Output = f64

The resulting type after applying the / operator.

fn div(self, rhs: Self) -> f64

Performs the / operation.

impl Div<f64> for Frequency

type Output = Self

The resulting type after applying the / operator.

fn div(self, rhs: f64) -> Self

Performs the / operation.

impl Measurement for Frequency

fn as_base_units(&self) -> f64

Get this quantity in the base units

fn from_base_units(units: f64) -> Self

Create a new quantity from the base units

fn get_base_units_name(&self) -> &'static str

Return the base unit for this type, as a string. For example “kilograms”

fn get_appropriate_units(&self) -> (&'static str, f64)

Returns a string containing the most appropriate units for this quantity, and a floating point value representing this quantity in those units. Useful when, for example, a length might be in millimeters if it is very small, or kilometers when it is very large.

fn pick_appropriate_units(
    &self,
    list: &[(&'static str, f64)]
) -> (&'static str, f64)

Given a list of units and their scale relative to the base unit, select the most appropriate one.

impl Mul<Frequency> for f64

type Output = Frequency

The resulting type after applying the * operator.

fn mul(self, rhs: Frequency) -> Frequency

Performs the * operation.

impl Mul<f64> for Frequency

type Output = Self

The resulting type after applying the * operator.

fn mul(self, rhs: f64) -> Self

Performs the * operation.

impl PartialEq<Frequency> for Frequency

fn eq(&self, other: &Self) -> 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 !=.

impl PartialOrd<Frequency> for Frequency

fn partial_cmp(&self, other: &Self) -> 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 Sub<Frequency> for Frequency

type Output = Self

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self

Performs the - operation.

impl Copy for Frequency

impl Eq for Frequency