Enum Range 

pub enum Range {
    Span {
        start: RangeBound,
        end: RangeBound,
    },
    CurrentLine,
    Whole,
    Selection,
    Custom(RangeId),
}

A vim range argument: which lines an ex-command or operator covers, before it is resolved against a document.

Symbolic on purpose: % or '<,'> means different lines in different buffers and at different times, so the value is carried unresolved (in a crate::CommandInvocation, a recorded macro, a plugin call) and each consumer resolves it at apply time.

Resolution coverage is uneven today. The dispatcher’s operator path resolves CurrentLine, Whole and Selection and rejects Span / Custom with crate::CommandError::InvalidArgs; :narrow resolves every form (patterns fall back to the cursor line, Custom to the cursor line). No parser in the tree produces Span or Custom yet.

Examples

use lattice_grammar::{Range, RangeBound};

// `:.,+10` -- from the cursor line to ten lines below it.
let r = Range::Span {
    start: RangeBound::CurrentLine,
    end: RangeBound::Offset {
        base: Box::new(RangeBound::CurrentLine),
        delta: 10,
    },
};
assert!(matches!(r, Range::Span { .. }));

// `:'<,'>` -- the last Visual selection, via its marks.
let visual = Range::Span {
    start: RangeBound::Mark('<'),
    end: RangeBound::Mark('>'),
};
assert_ne!(visual, Range::Selection); // same lines, different form

Variants

Span

:1,5, :'<,'>, :.,+10, etc. Both ends inclusive; a consumer that resolves start below end swaps them (vim asks, lattice swaps silently).

Fields

start: RangeBound

First line of the range.

end: RangeBound

Last line of the range (inclusive).

CurrentLine

:. – the cursor’s line.

Whole

:% – every line of the buffer.

Selection

The current Visual / active region (the default range while Visual is active). Unlike the other forms it keeps Visual’s shape: the dispatcher resolves it charwise (head-inclusive), linewise or blockwise according to the selection’s mode.

Custom(RangeId)

Plugin-registered custom range (e.g., a git-hunk-range plugin), identified by its registry id.

Trait Implementations

impl Clone for Range

fn clone(&self) -> Range

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Range

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Range

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Range

impl PartialEq for Range

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Range

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Range