Struct ChangeId 

pub struct ChangeId(/* private fields */);

An object hash used as stable identifier for a change.

Its bytes are identical to the wrapped ObjectId, but its textual form uses Jujutsu’s reverse-hex alphabet z through k instead of 0 through f.

Implementations

impl ChangeId

pub fn from_reverse_hex(buffer: &[u8]) -> Result<Self, Error>

Parse a complete SHA-1 or SHA-256 hash written with reverse-hex alphabet.

pub fn to_reverse_hex(&self) -> ReverseHexDisplay<'_>

Return a type which displays this ID in reverse-hex notation.

pub fn to_reverse_hex_with_len(&self, len: usize) -> ReverseHexDisplay<'_>

Return a type which displays at most len characters of this ID in reverse-hex notation.

Methods from Deref<Target = oid>

pub fn kind(&self) -> Kind

The kind of hash used for this instance.

pub fn first_byte(&self) -> u8

The first byte of the hash, commonly used to partition a set of object ids.

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

Interpret this object id as raw byte slice.

pub fn to_hex_with_len(&self, len: usize) -> HexDisplay<'_>

Return a type which can display itself in hexadecimal form with the len amount of characters.

pub fn to_hex(&self) -> HexDisplay<'_>

Return a type which displays this oid as hex in full.

pub fn to_prefix(&self, range: Range<usize>) -> Prefix

Return the bytes in range as a standalone, byte-aligned Prefix.

The range addresses raw hash bytes, not hexadecimal digits. Thus, each selected byte contributes two hexadecimal digits to the returned prefix. The selected bytes become the beginning of the prefix, independently of where they occurred in this object ID.

Panics

If range is out of bounds or has its start after its end.

pub fn hex_to_buf<'a>(&self, buf: &'a mut [u8]) -> &'a mut str

Write ourselves to the out in hexadecimal notation, returning the hex-string ready for display.

Panics

If the buffer isn’t big enough to hold twice as many bytes as the current binary size.

pub fn write_hex_to(&self, out: &mut dyn Write) -> Result<()>

Write ourselves to out in hexadecimal notation.

pub fn is_null(&self) -> bool

Returns true if this hash consists of all null bytes.

pub fn is_empty_blob(&self) -> bool

Returns true if this hash is equal to an empty blob.

pub fn is_empty_tree(&self) -> bool

Returns true if this hash is equal to an empty tree.

pub fn verify(&self, expected: &oid) -> Result<(), Error>

Verify that self matches the expected object ID.

Returns an Error containing both object IDs if they differ.

Trait Implementations

impl AsRef<oid> for ChangeId

fn as_ref(&self) -> &oid

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<oid> for ChangeId

fn borrow(&self) -> &oid

Immutably borrows from an owned value.

impl Clone for ChangeId

fn clone(&self) -> ChangeId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ChangeId

impl Debug for ChangeId

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

Formats the value using the given formatter.

impl Deref for ChangeId

type Target = oid

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'de> Deserialize<'de> for ChangeId

Available on crate feature serde only.

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ChangeId

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

Formats the value using the given formatter.

impl Eq for ChangeId

impl From<&oid> for ChangeId

fn from(value: &oid) -> Self

Converts to this type from the input type.

impl From<ChangeId> for ObjectId

fn from(value: ChangeId) -> Self

Converts to this type from the input type.

impl From<ChangeId> for Prefix

fn from(change_id: ChangeId) -> Self

Converts to this type from the input type.

impl From<ObjectId> for ChangeId

fn from(value: ObjectId) -> Self

Converts to this type from the input type.

impl FromStr for ChangeId

type Err = Error

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for ChangeId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for ChangeId

fn cmp(&self, other: &ChangeId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ChangeId

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<&str> for ChangeId

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<ChangeId> for str

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<ChangeId> for &str

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<ChangeId> for String

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<String> for ChangeId

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<str> for ChangeId

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for ChangeId

fn partial_cmp(&self, other: &ChangeId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for ChangeId

Available on crate feature serde only.

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ChangeId