Enum PageSelector 

pub enum PageSelector {
    Single(isize),
    Range(isize, isize),
    List(Vec<PageAtom>),
}

ImageMagick-style [N] / [N-M] / [A,B,…] page-selection suffix on an input path. input.pdf[0] selects page 0; input.pdf[2-5] selects pages 2, 3, 4, 5 (inclusive on both ends, like IM); input.pdf[-1] selects the last page; input.pdf[0,2,4] selects a comma-separated list (atoms may themselves be ranges, so [0-2,5,-1] picks pages 0, 1, 2, 5, and the last page).

The single-atom variants (Single / Range) are preserved for ergonomics — most callers only care about the one-atom case — but every comma-separated invocation lands as a List.

Variants

Single(isize)

Single page index. Negative values count from the end (-1 = last page).

Range(isize, isize)

Inclusive range start..=end. Either endpoint may be negative.

List(Vec<PageAtom>)

Comma-separated list of atoms. Order is preserved on resolve; duplicates are NOT collapsed (IM convention — [0,0,0] writes the same page three times). Empty list rejected at parse time.

Implementations

impl PageSelector

pub fn resolve(&self, total_pages: usize) -> Result<Vec<usize>, String>

Resolve the selector to a list of zero-based page indices, validated against total_pages. Negative indices -k resolve to total_pages - k. Order matches the IM source order: [0,2,4] yields [0, 2, 4]; [-1,0] yields [total_pages-1, 0]. Duplicates (e.g. [0,0]) are preserved.

Trait Implementations

impl Clone for PageSelector

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 PageSelector

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

Formats the value using the given formatter.

impl Eq for PageSelector

impl PartialEq for PageSelector

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PageSelector