pub struct TranslatorBuilder { /* private fields */ }
Expand description
A builder for constructing an AST->HIR translator.
Implementations§
Source§impl TranslatorBuilder
impl TranslatorBuilder
Sourcepub fn new() -> TranslatorBuilder
pub fn new() -> TranslatorBuilder
Create a new translator builder with a default c onfiguration.
Sourcepub fn build(&self) -> Translator
pub fn build(&self) -> Translator
Build a translator using the current configuration.
Sourcepub fn utf8(&mut self, yes: bool) -> &mut TranslatorBuilder
pub fn utf8(&mut self, yes: bool) -> &mut TranslatorBuilder
When disabled, translation will permit the construction of a regular expression that may match invalid UTF-8.
When enabled (the default), the translator is guaranteed to produce an expression that, for non-empty matches, will only ever produce spans that are entirely valid UTF-8 (otherwise, the translator will return an error).
Perhaps surprisingly, when UTF-8 is enabled, an empty regex or even
a negated ASCII word boundary (uttered as (?-u:\B)
in the concrete
syntax) will be allowed even though they can produce matches that split
a UTF-8 encoded codepoint. This only applies to zero-width or “empty”
matches, and it is expected that the regex engine itself must handle
these cases if necessary (perhaps by suppressing any zero-width matches
that split a codepoint).
Sourcepub fn line_terminator(&mut self, byte: u8) -> &mut TranslatorBuilder
pub fn line_terminator(&mut self, byte: u8) -> &mut TranslatorBuilder
Sets the line terminator for use with (?u-s:.)
and (?-us:.)
.
Namely, instead of .
(by default) matching everything except for \n
,
this will cause .
to match everything except for the byte given.
If .
is used in a context where Unicode mode is enabled and this byte
isn’t ASCII, then an error will be returned. When Unicode mode is
disabled, then any byte is permitted, but will return an error if UTF-8
mode is enabled and it is a non-ASCII byte.
In short, any ASCII value for a line terminator is always okay. But a non-ASCII byte might result in an error depending on whether Unicode mode or UTF-8 mode are enabled.
Note that if R
mode is enabled then it always takes precedence and
the line terminator will be treated as \r
and \n
simultaneously.
Note also that this doesn’t impact the look-around assertions
(?m:^)
and (?m:$)
. That’s usually controlled by additional
configuration in the regex engine itself.
Sourcepub fn case_insensitive(&mut self, yes: bool) -> &mut TranslatorBuilder
pub fn case_insensitive(&mut self, yes: bool) -> &mut TranslatorBuilder
Enable or disable the case insensitive flag (i
) by default.
Sourcepub fn multi_line(&mut self, yes: bool) -> &mut TranslatorBuilder
pub fn multi_line(&mut self, yes: bool) -> &mut TranslatorBuilder
Enable or disable the multi-line matching flag (m
) by default.
Sourcepub fn dot_matches_new_line(&mut self, yes: bool) -> &mut TranslatorBuilder
pub fn dot_matches_new_line(&mut self, yes: bool) -> &mut TranslatorBuilder
Enable or disable the “dot matches any character” flag (s
) by
default.
Sourcepub fn crlf(&mut self, yes: bool) -> &mut TranslatorBuilder
pub fn crlf(&mut self, yes: bool) -> &mut TranslatorBuilder
Enable or disable the CRLF mode flag (R
) by default.
Sourcepub fn swap_greed(&mut self, yes: bool) -> &mut TranslatorBuilder
pub fn swap_greed(&mut self, yes: bool) -> &mut TranslatorBuilder
Enable or disable the “swap greed” flag (U
) by default.
Sourcepub fn unicode(&mut self, yes: bool) -> &mut TranslatorBuilder
pub fn unicode(&mut self, yes: bool) -> &mut TranslatorBuilder
Enable or disable the Unicode flag (u
) by default.
Trait Implementations§
Source§impl Clone for TranslatorBuilder
impl Clone for TranslatorBuilder
Source§fn clone(&self) -> TranslatorBuilder
fn clone(&self) -> TranslatorBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for TranslatorBuilder
impl Debug for TranslatorBuilder
Source§impl Default for TranslatorBuilder
impl Default for TranslatorBuilder
Source§fn default() -> TranslatorBuilder
fn default() -> TranslatorBuilder
Auto Trait Implementations§
impl Freeze for TranslatorBuilder
impl RefUnwindSafe for TranslatorBuilder
impl Send for TranslatorBuilder
impl Sync for TranslatorBuilder
impl Unpin for TranslatorBuilder
impl UnwindSafe for TranslatorBuilder
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)