Struct SequenceEditor 

pub struct SequenceEditor<'a> { /* private fields */ }

A transactional, source-preserving editor for one YAML sequence.

Implementations

impl SequenceEditor<'_>

pub fn sort_by( self, compare: impl FnMut(&YamlDoc, NodeId, NodeId) -> Ordering, ) -> Result<(), YamlEditError>

Stably sorts items using semantic inspection of their lossless nodes.

pub fn insert( self, index: usize, value: &YamlFragment, ) -> Result<(), YamlEditError>

Inserts value before the item at index, or appends at len.

pub fn move_item(self, from: usize, to: usize) -> Result<(), YamlEditError>

Moves an existing item to its index in the finished sequence.

pub fn retain( self, predicate: impl FnMut(&YamlDoc, NodeId) -> bool, ) -> Result<(), YamlEditError>

Retains only items for which predicate returns true.

The predicate is called once per original item in source order. Removed items take their attached comments and other entry trivia with them.