#string #regex #comparison #string-pattern #match #generate

stringmatch

Allow the use of regular expressions or strings wherever you need string comparison

6 releases (3 breaking)

0.4.0 Jul 27, 2022
0.3.3 Dec 6, 2021
0.3.2 Jul 10, 2021
0.3.0 Jan 10, 2021
0.1.0 Sep 28, 2020

#647 in Text processing

Download history 5118/week @ 2024-05-16 4327/week @ 2024-05-23 4062/week @ 2024-05-30 4357/week @ 2024-06-06 3983/week @ 2024-06-13 3849/week @ 2024-06-20 3540/week @ 2024-06-27 3984/week @ 2024-07-04 4656/week @ 2024-07-11 5312/week @ 2024-07-18 5261/week @ 2024-07-25 5946/week @ 2024-08-01 6034/week @ 2024-08-08 3232/week @ 2024-08-15 5347/week @ 2024-08-22 5612/week @ 2024-08-29

21,171 downloads per month
Used in 26 crates (3 directly)

MIT license

19KB
302 lines

Crates.io docs.rs

Allow the use of regular expressions or strings wherever you need string comparison.

Examples

Using Generics / Monomorphization

This pattern is faster but generates more code, slightly larger binary.

If you don't have a preference, go with this option as the code is usually more convenient to write.

fn accept_needle<N>(needle: N) -> bool
where
    N: Needle,
{
    needle.is_match("Test")
}

And now all of the following will work:

accept_needle("Test");
accept_needle(String::from("Test"));
accept_needle(Regex::new("Test").unwrap());
accept_needle(Regex::new(r"^T.+t$").unwrap());

For string comparisons you can also use StringMatch which allows you to be more explicit about the comparison:

accept_needle(StringMatch::from("test").case_insensitive());
accept_needle(StringMatch::from("tes").partial());

By default StringMatch matches the whole string and is case sensitive (safety by default).

And finally there is the StringMatchable trait that is implemented for String and &str:

accept_needle("test".match_case_insensitive());
accept_needle("tes".match_partial());

Using Dynamic Dispatch

This pattern is slightly slower but generates less code, slightly smaller binary.

fn accept_needle(needle: &dyn Needle) -> bool
{
   needle.is_match("Test")
}

And now all of the following will work:

accept_needle(&"Test");
accept_needle(&String::from("Test"));
accept_needle(&Regex::new("Test").unwrap());
accept_needle(&Regex::new(r"^T.+t$").unwrap());
accept_needle(&StringMatch::from("test").case_insensitive());
accept_needle(&StringMatch::from("tes").partial());

LICENSE

This work is licensed under MIT.

SPDX-License-Identifier: MIT

Dependencies

~2.2–3.5MB
~58K SLoC