Struct StorePathRef 

pub struct StorePathRef<'a> {
    digest: [u8; 20],
    name: &'a str,
}

Like StorePath, but with a &str for the name.

Fields

digest: [u8; 20]

name: &'a str

Implementations

impl<'a> StorePathRef<'a>

pub fn digest(&self) -> &[u8; 20]

pub fn name(&self) -> &'a str

pub fn to_owned(&self) -> StorePath

pub fn from_bytes(s: &'a [u8]) -> Result<Self, ParseStorePathError>

Construct by passing the $digest-$name string that comes after STORE_DIR_WITH_SLASH.

pub fn from_name_and_digest( name: &'a str, digest: &[u8], ) -> Result<Self, ParseStorePathError>

Construct from a name and digest. The name is validated, and the digest checked for size.

pub fn from_name_and_digest_fixed( name: &'a str, digest: [u8; 20], ) -> Result<Self, ParseStorePathError>

Construct from a name and digest of correct length. The name is validated.

pub fn from_absolute_path(s: &'a [u8]) -> Result<Self, ParseStorePathError>

Construct from an absolute store path string. This is equivalent to calling StorePathRef::from_bytes, but stripping the STORE_DIR_WITH_SLASH prefix before.

pub fn from_absolute_path_full<'p, P>( path: &'p P, ) -> Result<(Self, &'p Path), ParseStorePathError>

where P: AsRef<Path> + 'p + ?Sized, 'p: 'a,

Decompose a string into a StorePathRef and a std::path::Path containing the rest of the path, or an error.

pub fn to_absolute_path(&self) -> String

Returns as an absolute store path (prefixed with STORE_DIR_WITH_SLASH).

pub fn as_absolute_path_fmt(&'a self) -> impl Display + 'a

Returns a formatter writing an absolute store path (prefixed with STORE_DIR_WITH_SLASH).

Trait Implementations

impl<'a> AtermWriteable for &StorePathRef<'a>

fn aterm_write(&self, writer: &mut impl Write) -> Result<()>

impl<'a> Clone for StorePathRef<'a>

fn clone(&self) -> StorePathRef<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for StorePathRef<'a>

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

Formats the value using the given formatter.

impl<'a, 'de: 'a> Deserialize<'de> for StorePathRef<'a>

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 StorePathRef<'_>

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

The string representation of a store path starts with a digest (20 bytes), crate::nixbase32-encoded, followed by a -, and ends with the name.

impl Equivalent<StorePath> for StorePathRef<'_>

Available on crate feature hashbrown only.

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

Compare self to key and return true if they are equal.

impl<'a> From<StorePathRef<'a>> for StorePath

fn from(value: StorePathRef<'a>) -> Self

Converts to this type from the input type.

impl<'a> Hash for StorePathRef<'a>

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 StorePathRef<'_>

StorePaths are sorted by their reverse digest to match the sorting order of the nixbase32-encoded string.

fn cmp(&self, other: &Self) -> 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<'a> PartialEq for StorePathRef<'a>

fn eq(&self, other: &StorePathRef<'a>) -> bool

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

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 StorePathRef<'_>

fn partial_cmp(&self, other: &Self) -> 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 StorePathRef<'_>

Available on crate feature serde only.

fn serialize<SR>(&self, serializer: SR) -> Result<SR::Ok, SR::Error>

where SR: Serializer,

Serialize this value into the given Serde serializer.

impl<'a> Eq for StorePathRef<'a>

impl<'a> StructuralPartialEq for StorePathRef<'a>