Struct PortSet 

pub struct PortSet { /* private fields */ }

A collection of TCP and UDP port ranges used for target discovery.

Under the hood, this stores disjoint ranges. Upon creation, all ranges are merged and sorted (canonicalized) to ensure O(log N) lookup times via binary search.

Implementations

impl PortSet

pub fn new() -> Self

Creates a new, empty PortSet.

pub fn len(&self) -> usize

Returns the total number of unique port/protocol combinations.

Note: This counts every individual port within every range.

pub fn is_empty(&self) -> bool

Returns true if no ports are defined for either protocol.

pub fn iter(&self) -> impl Iterator<Item = (u16, Protocol)> + '_

Returns an iterator over all individual ports in the set.

Yields TCP ports first, followed by UDP ports.

pub fn to_vec(&self) -> Vec<(u16, Protocol)>

Flattens the set into a vector of individual ports.

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

Checks if a specific TCP port is in the target set. Uses a highly optimized binary search over disjoint ranges.

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

Checks if a specific UDP port is in the target set. Uses a highly optimized binary search over disjoint ranges.

Trait Implementations

impl Clone for PortSet

fn clone(&self) -> PortSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PortSet

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

Formats the value using the given formatter.

impl Default for PortSet

fn default() -> Self

Returns a default PortSet containing common discovery services.

impl Eq for PortSet

impl FromIterator<(u16, Protocol)> for PortSet

fn from_iter<T: IntoIterator<Item = (u16, Protocol)>>(iter: T) -> Self

Creates a value from an iterator.

impl FromStr for PortSet

type Err = PortSetParseError

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 PartialEq for PortSet

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PortSet

impl TryFrom<&str> for PortSet

fn try_from(value: &str) -> Result<Self, Self::Error>

Parses a string into a canonicalized PortSet.

Format Support

• Individual: 80, 443
• Ranges: 1000-2000
• Protocols: Defaults to TCP. Use u: prefix for UDP (e.g., u:53).
• Mixed: 80, 443, u:53, 161-162

Examples

use zond_engine::core::models::port::set::PortSet;

let set = PortSet::try_from("80, u:53, 1000-1005").unwrap();
assert!(set.has_tcp(80));
assert!(set.has_udp(53));
assert_eq!(set.len(), 8); // 1 + 1 + 6

type Error = PortSetParseError

The type returned in the event of a conversion error.

impl TryFrom<String> for PortSet

type Error = PortSetParseError

The type returned in the event of a conversion error.

fn try_from(value: String) -> Result<Self, Self::Error>

Performs the conversion.