Struct StringContext 

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

The context attached to a Nix string: a set of store-path references that the string depends on. Plain string literals have an empty context.

Uses a Vec with linear deduplication instead of BTreeSet. Most strings have 0-2 context elements where linear search is faster than tree overhead, and Vec has the same size as BTreeSet (3 words) without per-node heap allocations for small sets.

Implementations

impl StringContext

pub fn new() -> Self

Create an empty context.

pub fn merge(&mut self, other: &StringContext)

Merge another context into this one.

pub fn add_plain(&mut self, path: impl Into<SmolStr>)

Add a plain store-path reference.

pub fn add_output( &mut self, drv: impl Into<SmolStr>, output: impl Into<SmolStr>, )

Add a derivation output reference.

pub fn add_drv_deep(&mut self, drv: impl Into<SmolStr>)

Add a derivation-deep reference.

pub fn is_empty(&self) -> bool

Whether this context set is empty.

pub fn len(&self) -> usize

Return the number of context elements.

pub fn iter(&self) -> impl Iterator<Item = &ContextElement>

Iterate over all context elements.

pub fn insert(&mut self, elem: ContextElement)

Insert a raw context element (deduplicating).

pub fn elements(&self) -> &[ContextElement]

Return the elements as a slice.

Trait Implementations

impl Clone for StringContext

fn clone(&self) -> StringContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StringContext

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

Formats the value using the given formatter.

impl Default for StringContext

fn default() -> StringContext

Returns the “default value” for a type.

impl Eq for StringContext

impl PartialEq for StringContext

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for StringContext