Module pex::helpers

combinator selection tutorial, choose your parser combinator

character

• match_char
• match_any
• match_char_range
• match_char_if
• match_char_set

match_char_set using the TrieSetSlice to match char set, it’s very fast.

You can also expand to or partten, but can be very slow

string

• match_str
• match_str_if
• match_str_until
• match_regex

You can also expand to or partten, but it might be a little slow

many

• match_repeats
• match_repeats_m_n

There’s no combinator for a+, a+ is recommended to expand to a a*

maybe

• match_optional
• skip

choice

• begin_choice
• try_match
• end_choice

See more in ChoiceHelper

peek

• match_positive
• match_negative

whitespace

• skip_whitespace
• skip_whitespace_if

comment

• comment_line
• comment_block
• comment_block_nested

string literal

• double_quote_string
• single_quote_string
• surround_pair
• surround_pair_with_escaper

number

• match_number
• match_number_if

Structs

• CharactersTrie
  Compact character set trie tree
• CommentBlock
  Parse the comment block
• CommentLine
  Parse a comment line, note this does not catch the newline, catch all if reach EOF
• HexColor
  Parse color tuple from string
• SurroundPair
  Represents a three-segment string match, including the head, body, and tail, see more example in surround_pair, double_quote_string, single_quote_string
• SurroundPattern
  Used to parse matching surround pairs without escaping, often used to match raw strings, such as r###"TEXT"### in rust and """TEXT""" in toml.
• UnicodeUnescape
  Parse the given state as a single quote string, \u1234
• ZeroBytePattern
  A pattern that matches a number with a leading zero and a base mark, such as 0x0123456789ABCDEF, 0o01234567, 0b01010101.

Functions

• ascii_whitespace
  Match ascii whitespace and newlines, fail if empty
• char
  Function form of the char combinator.
• decimal_string
  Match decimal string for later use
• make_from_str
  Make the from_str function from the pex parser
• omit
  Function form of the char combinator.
• optional
  Function form of the optional combinator.
• quotation_pair
  Parse the given state as a single quote string, such strings are allowed to contain escape symbols \\, if you want to disallow escape symbols, please use [surround_pair].
• quotation_pair_escaped
  Parse the given state as a single quote string, such strings are allowed to contain escape symbols \\, if you want to disallow escape symbols, please use [surround_pair].
• quotation_pair_nested
  Parse the given state as a single quote string, such strings are allowed to contain escape symbols \\, if you want to disallow escape symbols, please use [surround_pair].
• str
  Function form of the str combinator.
• surround_pair_with_escaper
  Parse the given state as a single quote string, all characters are allowed in strings except ', but including \'.
• unescape_us
  \u{}, \u{0}, \u{1234}, \u{123456}
• whitespace
  Match whitespace and newlines, fail if empty