Struct MatchEntry

pub struct MatchEntry { /* private fields */ }

A single entry in a MatchList.

Implementations

impl MatchEntry

pub fn new<T: Into<MatchPattern>>(pattern: T, ty: MatchType) -> Self

Create a new match entry.

pub fn include<T: Into<MatchPattern>>(pattern: T) -> Self

Create a new include-type match entry with default flags.

pub fn exclude<T: Into<MatchPattern>>(pattern: T) -> Self

Create a new exclude-type match entry with default flags.

pub fn flags(self, flags: MatchFlag) -> Self

Builder method to set the match flags to a specific value.

pub fn add_flags(self, flags: MatchFlag) -> Self

Builder method to add flag bits to the already present ones.

pub fn remove_flags(self, flags: MatchFlag) -> Self

Builder method to remove match flag bits.

pub fn toggle_flags(self, flags: MatchFlag) -> Self

Builder method to toggle flag bits.

pub fn match_type(&self) -> MatchType

pub fn match_type_mut(&mut self) -> &mut MatchType

Non-Builder method to change the match type.

pub fn pattern(&self) -> &MatchPattern

Directly access the pattern.

pub fn pattern_mut(&mut self) -> &mut MatchPattern

Non-Builder method to change the pattern.

pub fn match_flags(&self) -> MatchFlag

Directly access the match flags.

pub fn match_flags_mut(&mut self) -> &mut MatchFlag

Non-Builder method to change the flags.

pub fn parse_pattern<T: AsRef<[u8]>>( pattern: T, pattern_flags: PatternFlag, ty: MatchType, ) -> Result<Self, ParseError>

Parse a pattern into a MatchEntry while interpreting a leading exclamation mark as inversion and trailing slashes to match only directories.

pub fn matches_mode(&self, file_mode: u32) -> bool

Test this entry’s file type restrictions against a file mode retrieved from stat().

pub fn matches_path_suffix<T: AsRef<[u8]>>(&self, path: T) -> bool

Test whether this entry’s pattern matches any complete suffix of a path.

For the path /foo/bar/baz, this tests whether baz, bar/baz or foo/bar/baz is matched.

pub fn matches_path_exact<T: AsRef<[u8]>>(&self, path: T) -> bool

Test whether this entry’s pattern matches a path exactly.

pub fn matches<T: AsRef<[u8]>>(&self, path: T, file_mode: Option<u32>) -> bool

Check whether the path contains a matching suffix and the file mode match the expected file modes. This is a combination of using .matches_mode() and .matches_path_suffix().

pub fn matches_exact<T: AsRef<[u8]>>( &self, path: T, file_mode: Option<u32>, ) -> bool

Check whether the path contains a matching suffix and the file mode match the expected file modes. This is a combination of using .matches_mode() and .matches_path_exact().

Trait Implementations

impl Clone for MatchEntry

fn clone(&self) -> MatchEntry

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MatchEntry

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

Formats the value using the given formatter.