[−][src]Struct sequoia_openpgp::regex::Regex
A compiled OpenPGP regular expression for matching UTF-8 encoded strings.
A Regex
contains a regular expression compiled according to the
rules defined in Section 8 of RFC 4880 modulo two differences.
First, the compiler only works on UTF-8 strings (not bytes).
Second, ranges in character classes are between UTF-8 characters,
not just ASCII characters. Further, by default, strings that
don't pass a sanity check (in particular, include Unicode control
characters) never match. This behavior can be customized using
Regex::disable_sanitizations
.
Regular expressions are used to scope the trust that trust signatures extend.
When working with trust signatures, you'll usually want to use the
RegexSet
data structure, which already implements the correct
semantics.
See the module-level documentation for more details.
Implementations
impl Regex
[src]
pub fn new(re: &str) -> Result<Self>
[src]
Parses and compiles the regular expression.
By default, strings that don't pass a sanity check (in
particular, include Unicode control characters) never match.
This behavior can be customized using
Regex::disable_sanitizations
.
pub fn from_bytes(re: &[u8]) -> Result<Self>
[src]
Parses and compiles the regular expression.
Returns an error if re
is not a valid UTF-8 string.
By default, strings that don't pass a sanity check (in
particular, include Unicode control characters) never match.
This behavior can be customized using
Regex::disable_sanitizations
.
pub fn disable_sanitizations(&mut self, disabled: bool)
[src]
Controls whether matched strings must pass a sanity check.
If false
(the default), i.e., sanity checks are enabled, and
the string doesn't pass the sanity check (in particular, it
contains a Unicode control character according to
char::is_control
, including newlines and an embedded NUL
byte), this returns false
.
pub fn is_match(&self, s: &str) -> bool
[src]
Returns whether the regular expression matches the string.
If sanity checks are enabled (the default) and the string
doesn't pass the sanity check (in particular, it contains a
Unicode control character according to char::is_control
,
including newlines and an embedded NUL
byte), this returns
false
.
pub fn matches_userid(&self, u: &UserID) -> bool
[src]
Returns whether the regular expression matches the User ID.
If the User ID is not a valid UTF-8 string, this returns
false
.
If sanity checks are enabled (the default) and the string
doesn't pass the sanity check (in particular, it contains a
Unicode control character according to char::is_control
,
including newlines and an embedded NUL
byte), this returns
false
.
Trait Implementations
Auto Trait Implementations
impl !RefUnwindSafe for Regex
impl Send for Regex
impl Sync for Regex
impl Unpin for Regex
impl UnwindSafe for Regex
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> DynClone for T where
T: Clone,
[src]
T: Clone,
fn __clone_box(&self, Private) -> *mut ()
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> Same<T> for T
type Output = T
Should always be Self
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,