Struct Hunk

pub struct Hunk<'a>(pub Vec<Line<'a>>);

A grouping of consecutive edit lines for a document

Every line in a hunk must be consecutive and in ascending order.

Tuple Fields

0: Vec<Line<'a>>

Implementations

impl<'a> Hunk<'a>

pub fn new() -> Self

Create a new, empty hunk

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

Returns the first line number of the hunk

This will return None if the internal vector is empty

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

Returns the last line number of the hunk

This will return None if the internal vector is empty

pub fn can_push_back(&self, entry: &Entry<'a>) -> Result<(), HunkInsertionError>

Returns whether an entry can be pushed onto the current hunk.

This method is exposed so users can check if the push back operation would fail. This is useful if you want to avoid needing to do extra copies in case an incoming entry is can’t be added to the entry and you don’t want to have to deal with copying the entry for the next hunk.

This returns a result with the specific reason the entry couldn’t be inserted.

pub fn push_back( &mut self, entry: &'a Entry<'a>, ) -> Result<(), HunkInsertionError>

Append an entry to a hunk.

Entries can only be appended in ascending order (first to last). It is an error to append entries out of order. For example, you can’t insert an entry on line 1 after inserting an entry on line 5.

Trait Implementations

impl<'a> Clone for Hunk<'a>

fn clone(&self) -> Hunk<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Hunk<'a>

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

Formats the value using the given formatter.

impl<'a> Default for Hunk<'a>

fn default() -> Self

Returns the “default value” for a type.

impl<'a> PartialEq for Hunk<'a>

fn eq(&self, other: &Hunk<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Serialize for Hunk<'a>

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<'a> Eq for Hunk<'a>

impl<'a> StructuralPartialEq for Hunk<'a>