pub struct oid { /* private fields */ }Expand description
A borrowed reference to a hash identifying objects.
§Future Proofing
In case we wish to support multiple hashes with the same length we cannot discriminate
using the slice length anymore. To make that work, we will use the high bits of the
internal bytes slice length (a fat pointer, pointing to data and its length in bytes)
to encode additional information. Before accessing or returning the bytes, a new adjusted
slice will be constructed, while the high bits will be used to help resolving the
hash kind().
We expect to have quite a few bits available for such ‘conflict resolution’ as most hashes aren’t longer
than 64 bytes.
Implementations§
Source§impl oid
Conversion
impl oid
Conversion
Sourcepub fn try_from_bytes(digest: &[u8]) -> Result<&oid, Error>
Available on crate feature excludes only.
pub fn try_from_bytes(digest: &[u8]) -> Result<&oid, Error>
excludes only.Try to create a shared object id from a slice of bytes representing a hash digest
Sourcepub fn from_bytes_unchecked(value: &[u8]) -> &oid
Available on crate feature excludes only.
pub fn from_bytes_unchecked(value: &[u8]) -> &oid
excludes only.Create an OID from the input value slice without performing any safety check.
Use only once sure that value is a hash of valid length.
Source§impl oid
Access
impl oid
Access
Sourcepub fn kind(&self) -> Kind
Available on crate feature excludes only.
pub fn kind(&self) -> Kind
excludes only.The kind of hash used for this instance.
Sourcepub fn first_byte(&self) -> u8
Available on crate feature excludes only.
pub fn first_byte(&self) -> u8
excludes only.The first byte of the hash, commonly used to partition a set of object ids.
Sourcepub fn as_bytes(&self) -> &[u8] ⓘ
Available on crate feature excludes only.
pub fn as_bytes(&self) -> &[u8] ⓘ
excludes only.Interpret this object id as raw byte slice.
Sourcepub fn to_hex_with_len(&self, len: usize) -> HexDisplay<'_>
Available on crate feature excludes only.
pub fn to_hex_with_len(&self, len: usize) -> HexDisplay<'_>
excludes only.Return a type which can display itself in hexadecimal form with the len amount of characters.
Source§impl oid
Sha1 specific methods
impl oid
Sha1 specific methods
Sourcepub fn hex_to_buf<'a>(&self, buf: &'a mut [u8]) -> &'a mut str
Available on crate feature excludes only.
pub fn hex_to_buf<'a>(&self, buf: &'a mut [u8]) -> &'a mut str
excludes only.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.
Trait Implementations§
Source§impl<'de, 'a> Deserialize<'de> for &'a oidwhere
'de: 'a,
Manually created from a version that uses a slice, and we forcefully try to convert it into a borrowed array of the desired size
Could be improved by fitting this into serde.
Unfortunately the serde::Deserialize derive wouldn’t work for borrowed arrays.
impl<'de, 'a> Deserialize<'de> for &'a oidwhere
'de: 'a,
Manually created from a version that uses a slice, and we forcefully try to convert it into a borrowed array of the desired size
Could be improved by fitting this into serde.
Unfortunately the serde::Deserialize derive wouldn’t work for borrowed arrays.