logo
pub struct Regex { /* private fields */ }
Expand description

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

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.

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.

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.

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.

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

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Should always be Self

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.