Struct git_ref::packed::Buffer

pub struct Buffer { /* fields omitted */ }

A buffer containing a packed-ref file that is either memory mapped or fully in-memory depending on a cutoff.

The buffer is guaranteed to be sorted as per the packed-ref rules which allows some operations to be more efficient.

Implementations

impl Buffer

packed-refs specific functionality

pub fn iter(&self) -> Result<Iter<'_>, Error>

Return an iterator of references stored in this packed refs buffer, ordered by reference name.

pub fn iter_prefixed(
    &self,
    prefix: impl Into<BString>
) -> Result<Iter<'_>, Error>

Return an iterator yielding only references matching the given prefix, ordered by reference name.

impl Buffer

Initialization

pub fn open(
    path: impl Into<PathBuf>,
    use_memory_map_if_larger_than_bytes: u64
) -> Result<Self, Error>

Open the file at path and map it into memory if the file size is larger than use_memory_map_if_larger_than_bytes.

In order to allow fast lookups and optimizations, the contents of the packed refs must be sorted. If that’s not the case, they will be sorted on the fly with the data being written into a memory buffer.

impl Buffer

packed-refs specific functionality

pub fn find<'a, Name, E>(
    &self,
    name: Name
) -> Result<Option<Reference<'_>>, Error> where
    Name: TryInto<PartialName<'a>, Error = E>,
    Error: From<E>, 

Find a reference with the given name and return it.

pub fn find_existing<'a, Name, E>(
    &self,
    name: Name
) -> Result<Reference<'_>, Error> where
    Name: TryInto<PartialName<'a>, Error = E>,
    Error: From<E>, 

Find a reference with the given name and return it.

Trait Implementations

impl AsRef<[u8]> for Buffer

fn as_ref(&self) -> &[u8]

Performs the conversion.