Enum StringContext 

pub(crate) enum StringContext {
    Label(String),
    Description(String),
    ExpectedChar(char),
    ExpectedString(&'static str),
    ExpectedText(String),
}

A single piece of parser context that is attached to a ParseStack error.

In contrast to winnow’s StrContext, which only holds &'static str, this types allows messages as Strings.

This allows for setting error messages during runtime, which is a requirement for translated messages and generally provides more flexibility.

Variants

Label(String)

A description of what is currently being parsed.

Description(String)

A free-form description of what went wrong.

ExpectedChar(char)

An expected char literal.

ExpectedString(&'static str)

An expected string literal.

Use this for known, static syntax/keywords.

ExpectedText(String)

An free-form string that explains what is expected.

Use this for known, static syntax/keywords.

Implementations

impl StringContext

pub(crate) fn label(&self) -> Option<&str>

Returns the label text in case this context is a StringContext::Label.

pub(crate) fn expected(&self) -> Option<String>

Returns the expected literal if Self is of a literal variant.

fn render_char(c: char) -> String

Renders an expected char.

This is copied over from winnow’s StrContextValue Display impl.

Trait Implementations

impl Clone for StringContext

fn clone(&self) -> StringContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StringContext

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

Formats the value using the given formatter.

impl From<StrContext> for StringContext

fn from(context: StrContext) -> Self

Converts to this type from the input type.

impl From<StrContextValue> for StringContext

fn from(value: StrContextValue) -> Self

Converts to this type from the input type.