Struct ObjectIdPrefix 

pub struct ObjectIdPrefix { /* private fields */ }

A parsed abbreviated object id: the leading hex digits (“nibbles”) of a digest.

Parse the user’s hex once with ObjectIdPrefix::from_hex, then test candidates with ObjectIdPrefix::matches, which compares raw digest bytes without allocating. Sorted backends (pack indexes, key-value stores) can instead scan the inclusive id range ObjectIdPrefix::lowest..=ObjectIdPrefix::highest, which holds exactly the ids that match.

Examples

use grit_lib::objects::{HashAlgo, ObjectId, ObjectIdPrefix};

let id = ObjectId::from_hex("4b825dc642cb6eb9a060e54bf8d69288fbee4904")?;
let prefix = ObjectIdPrefix::from_hex("4B825", HashAlgo::Sha1)?;
assert_eq!(prefix.nibbles(), 5);
assert!(prefix.matches(&id));
assert!(!ObjectIdPrefix::from_hex("4b826", HashAlgo::Sha1)?.matches(&id));
assert!(prefix.lowest() <= id && id <= prefix.highest());

Implementations

impl ObjectIdPrefix

pub fn from_hex(hex: &str, algo: HashAlgo) -> Result<Self>

Parse hex (either case, possibly empty) as a prefix of algo object ids.

The empty prefix matches every id.

Errors

Returns Error::InvalidObjectId when hex contains a non-hex character or is longer than a full algo id (HashAlgo::hex_len).

pub fn nibbles(&self) -> usize

Number of hex digits in the prefix.

pub fn is_empty(&self) -> bool

Whether the prefix has no digits (and so matches every id).

pub fn algo(&self) -> HashAlgo

Hash algorithm the prefix was parsed for.

pub fn matches(&self, oid: &ObjectId) -> bool

Whether oid starts with this prefix.

Compares raw digest bytes (masking the last byte for an odd digit count), so the check never allocates. An id shorter than the prefix never matches.

pub fn lowest(&self) -> ObjectId

The smallest algo id that starts with this prefix (remaining digits all 0).

pub fn highest(&self) -> ObjectId

The largest algo id that starts with this prefix (remaining digits all f).

Trait Implementations

impl Clone for ObjectIdPrefix

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ObjectIdPrefix

impl Debug for ObjectIdPrefix

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

Formats the value using the given formatter.

impl Display for ObjectIdPrefix

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

Formats the value using the given formatter.

impl Eq for ObjectIdPrefix

impl PartialEq for ObjectIdPrefix

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ObjectIdPrefix