Struct MMFile 

pub struct MMFile { /* private fields */ }

Type representing an owned, compact file in libxdiff

Implementations

impl MMFile

pub fn new() -> MMFile

Create a new empty MMFile

pub fn from_bytes(bytes: &[u8]) -> MMFile

Create a new MMFile initialized with contents

pub fn size(&mut self) -> usize

Get size of stored data in bytes

pub fn is_compact(&self) -> bool

Checks if the entire file is a single allocation. In our library this is always true.

pub fn compute_patch(&mut self, other: &mut Self) -> Result<MMPatch, String>

Compute the patch to turn self into other

pub fn apply_patch( &mut self, patch: &mut MMPatch, ) -> Result<MMFile, (MMFile, MMFile)>

Apply a patch to a file. If successful, return the new file. If unsuccessful, return (successfully patched part, rejected parts)

pub fn diff_raw<CB>( &mut self, other: &mut MMFile, callback: CB, ) -> Result<(), String>

where CB: FnMut(&[u8]),

Compute the diff to turn self into other, returning diff through a callback one line at a time. Returns Err if callback panics.

pub unsafe fn diff_raw_nopanic<CB>( &mut self, other: &mut MMFile, callback: CB, ) -> Result<(), String>

where CB: FnMut(&[u8]) -> c_int,

Compute the diff to turn self into other, returning diff through a callback one line at a time. Callback should return 0 on success and -1 on failure.

Safety

The provided callback must not panic

pub fn merge3_raw<CBA, CBR>( base: &mut MMFile, f1: &mut MMFile, f2: &mut MMFile, accept_callback: CBA, reject_callback: CBR, ) -> Result<(), String>

where CBA: FnMut(&[u8]), CBR: FnMut(&[u8]),

Compute the file that results from merging two sets of changes to the base file. The resulting file is passed line-by-line to the accept_callback, any conflicting changes are passed to the reject_callback. Returns Err if any callback panics; panicking should be avoided wherever possible.

pub fn as_slice(&self) -> &[u8]

Get a view of the MMFile’s data as a slice

pub fn as_slice_mut(&mut self) -> &mut [u8]

Get a mutable view of the MMFile’s data as a slice

Trait Implementations

impl Clone for MMFile

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 MMFile

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

Formats the value using the given formatter.

impl Drop for MMFile

fn drop(&mut self)

Executes the destructor for this type.

impl PartialEq for MMFile

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

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

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

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