Struct RangeSet 

pub struct RangeSet { /* private fields */ }

An ordered set of integer string representations, supporting cluster range notation like "1-10,15,20-30/2".

Implementations

impl RangeSet

pub fn new() -> Self

Create an empty RangeSet.

pub fn parse(pattern: &str, autostep: Option<u32>) -> Result<Self>

Parse a range set from a string pattern like "1-4,6,8-12/2".

autostep is the user-facing autostep threshold (minimum element count to trigger step folding). Pass None to disable.

pub fn add_range(&mut self, start: i64, stop: i64, step: i64, pad: u32)

Add a range of integers [start, stop) with given step and padding.

pub fn len(&self) -> usize

Number of individual values in the set.

pub fn is_empty(&self) -> bool

Whether the set is empty.

pub fn add_str(&mut self, s: &str)

Add a string element directly.

pub fn add_int(&mut self, value: i64, pad: u32)

Add an integer element with optional zero-padding.

pub fn remove_str(&mut self, s: &str)

Remove an element by string. Panics if not present.

pub fn discard_str(&mut self, s: &str)

Remove an element by string if present (no error).

pub fn contains_str(&self, s: &str) -> bool

Check if a string element is in the set.

pub fn contains_int(&self, value: i64) -> bool

Check if an integer (unpadded) is in the set.

pub fn sorted(&self) -> Vec<String>

Get sorted elements as owned strings.

pub fn striter(&self) -> impl Iterator<Item = String>

Iterate as strings (owned).

pub fn intiter(&self) -> impl Iterator<Item = i64>

Iterate as integer values.

pub fn union(&self, other: &RangeSet) -> RangeSet

Return the union of two range sets.

pub fn intersection(&self, other: &RangeSet) -> RangeSet

Return the intersection of two range sets.

pub fn difference(&self, other: &RangeSet) -> RangeSet

Return the difference (self - other).

pub fn symmetric_difference(&self, other: &RangeSet) -> RangeSet

Return the symmetric difference.

pub fn update(&mut self, other: &RangeSet)

Update self to be the union with other.

pub fn intersection_update(&mut self, other: &RangeSet)

Update self to be the intersection with other.

pub fn difference_update(&mut self, other: &RangeSet)

Update self to be self - other.

pub fn symmetric_difference_update(&mut self, other: &RangeSet)

Update self to be the symmetric difference with other.

pub fn autostep(&self) -> Option<u32>

Get autostep value (user-facing: minimum node count, or None if disabled).

pub fn set_autostep(&mut self, val: Option<u32>)

Set autostep value (user-facing: minimum node count, or None to disable).

pub fn padding(&self) -> Option<usize>

Get the maximum padding value in the set.

Trait Implementations

impl Clone for RangeSet

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RangeSet

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

Formats the value using the given formatter.

impl Default for RangeSet

fn default() -> Self

Returns the “default value” for a type.

impl Display for RangeSet

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

Formats the value using the given formatter.