Struct Depfile

pub struct Depfile<'a> { /* private fields */ }

Structure of a .d depfile. Constructed with parse

The Debug ({:?}) format prints unescaped symbols. To reconstruct the depfile as string, consider using an iterator and escape

Implementations

impl Depfile<'_>

pub fn len(&self) -> usize

Get number of targets in the depfile

pub fn is_empty(&self) -> bool

Return true if the depfile contains no target

pub fn sort(&mut self)

Sort the targets to enable binary search

pub fn binary_search(&self, target: &str) -> Option<&[Cow<'_, str>]>

Binary search for a target and return its dependencies. self must be sorted.

The target symbol is compared literally, i.e. the same paths with different separators are considered different.

pub fn find(&self, target: &str) -> Option<&[Cow<'_, str>]>

Find the target and return its dependencies.

The target symbol is compared literally, i.e. the same paths with different separators are considered different.

pub fn iter(&self) -> DepfileIter<'_>

Iterate over (target, deps) pairs.

The deps are not recursive, use recurse_deps for recursive traversal of dependencies using DFS

pub fn recurse_deps(&self, target: &str) -> DepfileRecurDeps<'_>

Recursively iterator over all dependencies of the target.

Each dependency will only be returned once

Trait Implementations

impl<'a> Clone for Depfile<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Depfile<'_>

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

Formats the value using the given formatter.

impl<'a> Default for Depfile<'a>

fn default() -> Depfile<'a>

Returns the “default value” for a type.

impl<'a> PartialEq for Depfile<'a>

fn eq(&self, other: &Depfile<'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<'a> TryFrom<&'a str> for Depfile<'a>

type Error = usize

The type returned in the event of a conversion error.

fn try_from(value: &'a str) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> Eq for Depfile<'a>

impl<'a> StructuralPartialEq for Depfile<'a>