Enum regex_syntax::ast::ErrorKind

pub enum ErrorKind {
    CaptureLimitExceeded,
    ClassEscapeInvalid,
    ClassRangeInvalid,
    ClassRangeLiteral,
    ClassUnclosed,
    DecimalEmpty,
    DecimalInvalid,
    EscapeHexEmpty,
    EscapeHexInvalid,
    EscapeHexInvalidDigit,
    EscapeUnexpectedEof,
    EscapeUnrecognized,
    FlagDanglingNegation,
    FlagDuplicate {
        original: Span,
    },
    FlagRepeatedNegation {
        original: Span,
    },
    FlagUnexpectedEof,
    FlagUnrecognized,
    GroupNameDuplicate {
        original: Span,
    },
    GroupNameEmpty,
    GroupNameInvalid,
    GroupNameUnexpectedEof,
    GroupUnclosed,
    GroupUnopened,
    NestLimitExceeded(u32),
    RepetitionCountInvalid,
    RepetitionCountDecimalEmpty,
    RepetitionCountUnclosed,
    RepetitionMissing,
    UnicodeClassInvalid,
    UnsupportedBackreference,
    UnsupportedLookAround,
    // some variants omitted
}

The type of an error that occurred while building an AST.

Variants

CaptureLimitExceeded

The capturing group limit was exceeded.

Note that this represents a limit on the total number of capturing groups in a regex and not necessarily the number of nested capturing groups. That is, the nest limit can be low and it is still possible for this error to occur.

ClassEscapeInvalid

An invalid escape sequence was found in a character class set.

ClassRangeInvalid

An invalid character class range was found. An invalid range is any range where the start is greater than the end.

ClassRangeLiteral

An invalid range boundary was found in a character class. Range boundaries must be a single literal codepoint, but this error indicates that something else was found, such as a nested class.

ClassUnclosed

An opening [ was found with no corresponding closing ].

DecimalEmpty

Note that this error variant is no longer used. Namely, a decimal number can only appear as a repetition quantifier. When the number in a repetition quantifier is empty, then it gets its own specialized error, RepetitionCountDecimalEmpty.

DecimalInvalid

An invalid decimal number was given where one was expected.

EscapeHexEmpty

A bracketed hex literal was empty.

EscapeHexInvalid

A bracketed hex literal did not correspond to a Unicode scalar value.

EscapeHexInvalidDigit

An invalid hexadecimal digit was found.

EscapeUnexpectedEof

EOF was found before an escape sequence was completed.

EscapeUnrecognized

An unrecognized escape sequence.

FlagDanglingNegation

A dangling negation was used when setting flags, e.g., i-.

FlagDuplicate

A flag was used twice, e.g., i-i.

Fields of FlagDuplicate

original: Span

The position of the original flag. The error position points to the duplicate flag.

FlagRepeatedNegation

The negation operator was used twice, e.g., -i-s.

Fields of FlagRepeatedNegation

original: Span

The position of the original negation operator. The error position points to the duplicate negation operator.

FlagUnexpectedEof

Expected a flag but got EOF, e.g., (?.

FlagUnrecognized

Unrecognized flag, e.g., a.

GroupNameDuplicate

A duplicate capture name was found.

Fields of GroupNameDuplicate

original: Span

The position of the initial occurrence of the capture name. The error position itself points to the duplicate occurrence.

GroupNameEmpty

A capture group name is empty, e.g., (?P<>abc).

GroupNameInvalid

An invalid character was seen for a capture group name. This includes errors where the first character is a digit (even though subsequent characters are allowed to be digits).

GroupNameUnexpectedEof

A closing > could not be found for a capture group name.

GroupUnclosed

An unclosed group, e.g., (ab.

The span of this error corresponds to the unclosed parenthesis.

GroupUnopened

An unopened group, e.g., ab).

NestLimitExceeded(u32)

The nest limit was exceeded. The limit stored here is the limit configured in the parser.

RepetitionCountInvalid

The range provided in a counted repetition operator is invalid. The range is invalid if the start is greater than the end.

RepetitionCountDecimalEmpty

An opening { was not followed by a valid decimal value. For example, x{} or x{]} would fail.

RepetitionCountUnclosed

An opening { was found with no corresponding closing }.

RepetitionMissing

A repetition operator was applied to a missing sub-expression. This occurs, for example, in the regex consisting of just a * or even (?i)*. It is, however, possible to create a repetition operating on an empty sub-expression. For example, ()* is still considered valid.

UnicodeClassInvalid

The Unicode class is not valid. This typically occurs when a \p is followed by something other than a {.

UnsupportedBackreference

When octal support is disabled, this error is produced when an octal escape is used. The octal escape is assumed to be an invocation of a backreference, which is the common case.

UnsupportedLookAround

When syntax similar to PCRE’s look-around is used, this error is returned. Some example syntaxes that are rejected include, but are not necessarily limited to, (?=re), (?!re), (?<=re) and (?<!re). Note that all of these syntaxes are otherwise invalid; this error is used to improve the user experience.

Trait Implementations

impl Clone for ErrorKind

fn clone(&self) -> ErrorKind

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ErrorKind

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

Formats the value using the given formatter.

impl Display for ErrorKind

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

Formats the value using the given formatter.

impl Eq for ErrorKind

impl PartialEq<ErrorKind> for ErrorKind

fn eq(&self, other: &ErrorKind) -> bool

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

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

This method tests for !=.

impl StructuralEq for ErrorKind

impl StructuralPartialEq for ErrorKind