Struct PortRange 

pub struct PortRange {
    lo: u16,
    hi: u16,
}

A PortRange is a set of consecutively numbered TCP or UDP ports.

Example

use tor_netdoc::types::policy::PortRange;

let r: PortRange = "22-8000".parse().unwrap();
assert!(r.contains(128));
assert!(r.contains(22));
assert!(r.contains(8000));

assert!(! r.contains(21));
assert!(! r.contains(8001));

Fields

lo: u16

The first port in this range.

hi: u16

The last port in this range.

Implementations

impl PortRange

const fn new_unchecked(lo: u16, hi: u16) -> Self

Create a new port range spanning from lo to hi, asserting that the correct invariants hold.

pub const fn new_all() -> Self

Create a port range containing all ports.

pub fn new(lo: u16, hi: u16) -> Option<Self>

Create a new PortRange.

The Portrange contains all ports between lo and hi inclusive.

Returns None if lo is greater than hi, or if either is zero.

pub fn from_range(r: RangeInclusive<u16>) -> Option<Self>

Create a new PortRange from a RangeInclusive

Returns None if the range is ill-formed, or contains zero.

pub fn to_range(self) -> RangeInclusive<u16>

Create a new PortRange from a RangeInclusive

Returns None if the range is ill-formed, or contains zero.

pub fn contains(&self, port: u16) -> bool

Return true if a port is in this range.

pub fn is_all(&self) -> bool

Return true if this range contains all ports.

fn compare_to_port(&self, port: u16) -> Ordering

Helper for binary search: compare this range to a port.

This range is “equal” to all ports that it contains. It is “greater” than all ports that precede its starting point, and “less” than all ports that follow its ending point.

Trait Implementations

impl Clone for PortRange

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PortRange

impl Debug for PortRange

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

Formats the value using the given formatter.

impl Display for PortRange

A PortRange is displayed as a number if it contains a single port, and as a start point and end point separated by a dash if it contains more than one port.

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

Formats the value using the given formatter.

impl Eq for PortRange

impl FromStr for PortRange

type Err = PolicyError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, PolicyError>

Parses a string s to return a value of this type.

impl Hash for PortRange

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 NormalItemArgument for PortRange

impl PartialEq for PortRange

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PortRange