Struct sub_strs::GlobSet

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

Glob set

This struct contains a set of Glob’s.

Notes

For #![no_std]: this struct uses a vector inside. Since at the time of implementation, HashSet was not available.

Implementations

impl<'a> GlobSet<'a>

pub fn from_iter<I>(strs: I) -> Option<Self> where
    I: Iterator<Item = Cow<'a, str>>, 

Makes new instance from an iterator of Cow<'a, str>

Notes

• Empty strings will be ignored.
• If the iterator contains no globs, None is returned.
• For #![no_std] users: this function takes little effort to remove duplicates. You should help with that yourself (by not providing duplicates).

Examples

use sub_strs::GlobSet;

let glob_set = GlobSet::from_iter("*.rs|*.md".split('|').map(|s| s.into())).unwrap();
assert!(glob_set.any("this.rs"));
assert!(glob_set.any("that.md"));
assert!(glob_set.any("not-this") == false);

pub fn merge<I>(iter: I) -> Option<Self> where
    I: Iterator<Item = Self>, 

Merges an iterator of GlobSet<'a> into one

Notes

• If there are no inner Glob’s, None is returned.
• For #![no_std] users: this function takes little effort to remove duplicates. You should help with that yourself (by not providing duplicates).

Examples

use sub_strs::GlobSet;

let program_args = &["*.svg,*.OGG", "*.md"];
let glob_set = GlobSet::merge(
    program_args.iter().filter_map(|s|
        GlobSet::from_iter(s.to_lowercase().split(',').map(|s| s.to_string().into()))
    )
);
assert!(glob_set.map(|g| g.any("some.ogg")).unwrap_or(false));

pub fn any<S>(&self, s: S) -> bool where
    S: AsRef<str>, 

Checks if any glob inside matches the input string

Trait Implementations

impl<'a> Debug for GlobSet<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq<GlobSet<'a>> for GlobSet<'a>

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Eq for GlobSet<'a>

impl<'a> StructuralEq for GlobSet<'a>

impl<'a> StructuralPartialEq for GlobSet<'a>