Enum gix::ObjectId

Sha1([u8; 20])

A SHA 1 hash digest

Implementations§

impl ObjectId

Hash decoding

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

Available on crate feature excludes only.

Create an instance from a buffer of 40 bytes encoded with hexadecimal notation.

Such a buffer can be obtained using oid::write_hex_to(buffer)

impl ObjectId

Access and conversion

pub fn kind(&self) -> Kind

Available on crate feature excludes only.

Returns the kind of hash used in this instance.

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

Available on crate feature excludes only.

Return the raw byte slice representing this hash.

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

Available on crate feature excludes only.

Return the raw mutable byte slice representing this hash.

pub const fn empty_blob(hash: Kind) -> ObjectId

Available on crate feature excludes only.

The hash of an empty blob.

pub const fn empty_tree(hash: Kind) -> ObjectId

Available on crate feature excludes only.

The hash of an empty tree.

pub const fn null(kind: Kind) -> ObjectId

Available on crate feature excludes only.

Returns an instances whose bytes are all zero.

pub fn is_null(&self) -> bool

Available on crate feature excludes only.

Returns true if this hash consists of all null bytes.

pub fn is_empty_blob(&self) -> bool

Available on crate feature excludes only.

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

pub fn is_empty_tree(&self) -> bool

Available on crate feature excludes only.

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

impl ObjectId

Lifecycle

pub fn from_bytes_or_panic(bytes: &[u8]) -> ObjectId

Available on crate feature excludes only.

Convert bytes into an owned object Id or panic if the slice length doesn’t indicate a supported hash.

Use Self::try_from(bytes) for a fallible version.

impl ObjectId

This impl block contains no items.

Sha1 hash specific methods

Methods from Deref<Target = oid>§

pub fn kind(&self) -> Kind

Available on crate feature excludes only.

The kind of hash used for this instance.

pub fn first_byte(&self) -> u8

Available on crate feature excludes only.

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

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

Available on crate feature excludes only.

Interpret this object id as raw byte slice.

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

Available on crate feature excludes only.

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

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

Available on crate feature excludes only.

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

pub fn is_null(&self) -> bool

Available on crate feature excludes only.

Returns true if this hash consists of all null bytes.

pub fn hex_to_buf(&self, buf: &mut [u8]) -> usize

Available on crate feature excludes only.

Write ourselves to the out in hexadecimal notation, returning the amount of written bytes.

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<(), Error>

Available on crate feature excludes only.

Write ourselves to out in hexadecimal notation.

Trait Implementations§

impl AsRef<oid> for ObjectId

fn as_ref(&self) -> &oid

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

impl Borrow<oid> for ObjectId

fn borrow(&self) -> &oid

Immutably borrows from an owned value. Read more

impl Clone for ObjectId

fn clone(&self) -> ObjectId

Returns a copy of the value. Read more

1.0.0 · source§

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

Performs copy-assignment from source. Read more

impl Debug for ObjectId

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

Formats the value using the given formatter. Read more

impl Deref for ObjectId

type Target = oid

The resulting type after dereferencing.

fn deref(&self) -> &<ObjectId as Deref>::Target

Dereferences the value.

impl<'de> Deserialize<'de> for ObjectId

fn deserialize<D>( deserializer: D, ) -> Result<ObjectId, <D as Deserializer<'de>>::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

impl Display for ObjectId

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

Formats the value using the given formatter. Read more

impl From<&oid> for ObjectId

fn from(v: &oid) -> ObjectId

Converts to this type from the input type.

impl From<[u8; 20]> for ObjectId

fn from(v: [u8; 20]) -> ObjectId

Converts to this type from the input type.

impl<'repo> From<Id<'repo>> for ObjectId

fn from(v: Id<'repo>) -> Self

Converts to this type from the input type.

impl From<ObjectId> for Prefix

fn from(oid: ObjectId) -> Prefix

Converts to this type from the input type.

impl FromStr for ObjectId

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<ObjectId, <ObjectId as FromStr>::Err>

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

impl Hash for ObjectId

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

Feeds this value into the given Hasher. Read more

1.3.0 · source§

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

Feeds a slice of this type into the given Hasher. Read more

impl ObjectIdExt for ObjectId

fn ancestors<Find>(self, find: Find) -> Simple<Find, fn(_: &oid) -> bool> ⓘ
where Find: Find,

Create an iterator over the ancestry of the commits reachable from this id, which must be a commit.

fn attach(self, repo: &Repository) -> Id<'_>

Infuse this object id repo access.

impl Ord for ObjectId

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

This method returns an Ordering between self and other. Read more

1.21.0 · source§

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

Compares and returns the maximum of two values. Read more

1.21.0 · source§

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

Compares and returns the minimum of two values. Read more

1.50.0 · source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized + PartialOrd,

Restrict a value to a certain interval. Read more

impl PartialEq<&oid> for ObjectId

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

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

1.0.0 · source§

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<'repo> PartialEq<Id<'repo>> for ObjectId

fn eq(&self, other: &Id<'repo>) -> bool

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

1.0.0 · source§

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 PartialEq<ObjectId> for &oid

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

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

1.0.0 · source§

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<'repo> PartialEq<ObjectId> for Id<'repo>

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

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

1.0.0 · source§

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 PartialEq for ObjectId

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

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

1.0.0 · source§

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 PartialOrd for ObjectId

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

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

1.0.0 · source§

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

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

1.0.0 · source§

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

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

1.0.0 · source§

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

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

1.0.0 · source§

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

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

impl Serialize for ObjectId

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>
where S: Serializer,

Serialize this value into the given Serde serializer. Read more

impl TryFrom<&[u8]> for ObjectId

type Error = Error

The type returned in the event of a conversion error.

fn try_from( bytes: &[u8], ) -> Result<ObjectId, <ObjectId as TryFrom<&[u8]>>::Error>

Performs the conversion.

impl TryFrom<Target> for ObjectId

type Error = Target

The type returned in the event of a conversion error.

fn try_from( value: Target, ) -> Result<ObjectId, <ObjectId as TryFrom<Target>>::Error>

Performs the conversion.

impl Copy for ObjectId

impl Eq for ObjectId

impl StructuralPartialEq for ObjectId

Auto Trait Implementations§

impl UnwindSafe for ObjectId

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)

Performs copy-assignment from self to dst. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> Same for T

type Output = T

Should always be Self

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T> ToString for T
where T: Display + ?Sized,

default fn to_string(&self) -> String

Converts the given value to a String. Read more

impl<T, U> TryFrom for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

impl<T, U> TryInto for T
where U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.