Struct SelectionSet 

pub struct SelectionSet { /* private fields */ }

The editor’s selections: a primary plus zero or more extras. Invariants (enforced by normalize): extras sorted, deduped, none equal to the primary’s head.

Implementations

impl SelectionSet

pub fn primary(&self) -> Selection

pub fn heads(&self) -> Vec<usize>

Every head, primary first (0013 §3 cascade order).

pub fn extra_heads(&self) -> &[Selection]

pub fn count(&self) -> usize

pub fn set_head(&mut self, head: usize)

Move the primary head (motions, edits).

pub fn collapse_primary(&mut self, at: usize)

Move head and anchor together (leaving visual mode, plain moves).

pub fn stretch_primary(&mut self, anchor: usize, head: usize)

Enter/extend visual: the anchor stays, the head walks.

pub fn toggle_extra(&mut self)

Q: drop the extra under the primary, else plant one there.

pub fn plant_extra(&mut self, at: usize)

Plant an extra cursor (both ends at at). Never on the primary’s head — Space c and match-planting skip that spot; stacking on the primary is Q’s job (toggle_extra).

pub fn normalize(&mut self)

Sorted, deduped. An extra MAY sit on the primary’s head — Q plants exactly there, then a motion walks them apart (0013).

pub fn collapse_extras(&mut self)

Esc: extras die, primary stays.

pub fn set_extras(&mut self, heads: impl IntoIterator<Item = usize>)

Replace the extras wholesale — the motion cascade replants computed heads, and stacked-on-primary extras survive (they were planted by Q on purpose, 0013 §3).

pub fn plant_extra_selection(&mut self, anchor: usize, head: usize)

Plant a real (stretched) extra selection — occurrence selection (0049 §7) keeps anchor/head, unlike the collapsed Space c cursor. Skips ranges already owned by the primary or an extra.

pub fn set_extra_selections( &mut self, selections: impl IntoIterator<Item = Selection>, )

Replace the extras wholesale, keeping each anchor/head and direction — occurrence selections are real ranges, so the motion/insert cascades replant full selections where the plain cursor flow replants heads.

pub fn remove_extra(&mut self, selection: Selection) -> Option<Selection>

Drop one extra by exact identity (occurrence pop, 0049 §7). Returns the removed selection when one matched.

pub fn map_positions(&mut self, map: impl FnMut(usize) -> usize)

Map every endpoint in place, preserving selection direction and capacity.

pub fn remap(&mut self, at: usize, delta: isize)

After an edit shifted bytes: remap every head/anchor by delta at a point (the mirrored-edit cascade’s bookkeeping).

Trait Implementations

impl Clone for SelectionSet

fn clone(&self) -> SelectionSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SelectionSet

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

Formats the value using the given formatter.

impl Default for SelectionSet

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SelectionSet

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SelectionSet

impl PartialEq for SelectionSet

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SelectionSet

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 SelectionSet