Struct git_repository::Id

source · [−]

pub struct Id<'r> { /* private fields */ }

Expand description

An ObjectId with access to a repository.

Implementations

impl<'repo> Id<'repo>

An object id infused with Easy.

pub fn object(&self) -> Result<Object<'repo>, Error<Error>>

Find the Object associated with this object id, and consider it an error if it doesn’t exist.

Note

There can only be one ObjectRef per Easy. To increase that limit, clone the Easy.

pub fn try_object(&self) -> Result<Option<Object<'repo>>, Error>

Try to find the Object associated with this object id, and return None if it’s not available locally.

Note

There can only be one ObjectRef per Easy. To increase that limit, clone the Easy.

pub fn shorten(&self) -> Result<Prefix, Error>

Turn this object id into a shortened id with a length in hex as configured by core.abbrev.

pub fn shorten_or_id(&self) -> Prefix

Turn this object id into a shortened id with a length in hex as configured by core.abbrev, or default to a prefix which equals our id in the unlikely error case.

impl<'repo> Id<'repo>

pub fn detach(self) -> ObjectId

Turn this instance into its bare ObjectId.

impl<'repo> Id<'repo>

pub fn ancestors(&self) -> Platform<'repo>

Obtain a platform for traversing ancestors of this commit.

Note that unless error_on_missing_commit() is enabled, which be default it is not, one will always see an empty iteration even if this id is not a commit, instead of an error. If this is undesirable, it’s best to check for the correct object type before creating an iterator.

Methods from Deref<Target = oid>

pub fn kind(&self) -> Kind

The kind of hash used for this Digest

pub fn first_byte(&self) -> u8

The first byte of the hash, commonly used to partition a set of Ids

pub fn as_bytes(&self) -> &[u8]ⓘNotable traits for &[u8]`impl Read for &[u8]impl Write for &mut [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 hex_to_buf(&self, buf: &mut [u8]) -> usize

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: impl Write) -> Result<(), Error>

Write ourselves to out in hexadecimal notation

Trait Implementations

impl<'repo> AsRef<oid> for Id<'repo>

fn as_ref(&self) -> &oid

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

impl<'r> Clone for Id<'r>

fn clone(&self) -> Id<'r>

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

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

Formats the value using the given formatter. Read more

impl<'repo> Deref for Id<'repo>

type Target = oid

The resulting type after dereferencing.

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

Dereferences the value.

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

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

Converts to this type from the input type.

impl<'a> Hash for Id<'a>

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

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,

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

impl<'repo> PartialEq<Id<'repo>> for Id<'repo>

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

This method tests for self and other values to be equal, and is used by ==. Read more

1.0.0 · source

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

This method tests for !=.

impl<'repo> PartialEq<Object<'repo>> for Id<'repo>

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

This method tests for self and other values to be equal, and is used by ==. Read more

1.0.0 · source

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

This method tests for !=.

impl<'repo> PartialEq<ObjectDetached> for Id<'repo>

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

This method tests for self and other values to be equal, and is used by ==. Read more

1.0.0 · source

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

This method tests for !=.

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

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

This method tests for self and other values to be equal, and is used by ==. Read more

1.0.0 · source

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

This method tests for !=.

impl<'repo> PartialEq<oid> for Id<'repo>

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

This method tests for self and other values to be equal, and is used by ==. Read more

1.0.0 · source

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

This method tests for !=.

impl<'a> PartialOrd<Id<'a>> for Id<'a>

fn partial_cmp(&self, other: &Id<'a>) -> 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

This method 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

This method 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

This method 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

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

impl<'r> Copy for Id<'r>

Auto Trait Implementations

impl<'r> !RefUnwindSafe for Id<'r>

impl<'r> !Send for Id<'r>

impl<'r> !Sync for Id<'r>

impl<'r> Unpin for Id<'r>

impl<'r> !UnwindSafe for Id<'r>

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,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

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

const: unstable · source

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

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

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

const: unstable · source

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> Pointable for T

const ALIGN: usize = mem::align_of::<T>()

The alignment of pointer.

type Init = T

The type for initializers.

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

impl<T> Same<T> 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, U> TryFrom<U> for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

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

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.