Struct Candidate

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

A candidate path for matching.

All glob matching in this crate operates on Candidate values. Constructing candidates has a very small cost associated with it, so callers may find it beneficial to amortize that cost when matching a single path against multiple globs or sets of globs.

Implementations

impl<'a> Candidate<'a>

pub fn new<P: AsRef<Path> + ?Sized>(path: &'a P) -> Candidate<'a>

Create a new candidate for matching from the given path.

pub fn from_bytes<P: AsRef<[u8]> + ?Sized>(path: &'a P) -> Candidate<'a>

Create a new candidate for matching from the given path as a sequence of bytes.

Generally speaking, this routine expects the bytes to be conventionally UTF-8. It is legal for the byte sequence to contain invalid UTF-8. However, if the bytes are in some other encoding that isn’t ASCII compatible (for example, UTF-16), then the results of matching are unspecified.

Trait Implementations

impl<'a> Clone for Candidate<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Candidate<'a>

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

Formats the value using the given formatter.