Crate parser_compose

See the README.md for the introduction and examples

Parsers

Any rust item that implements the Parser trait can parse input by calling try_parse()

Strings and slices implement the Parser trait:

• &str
• slices

Additionally the Parser trait is implemented for all functions with the following signature.

Lastly, a few utility parsers are provided:

• utf8_scalar()
• byte()
• first_utf8_scalar()
• first_slice_item()

Parser combinators

The associated methods on the Parser trait are used to combine parsers.

• or()
• when()
• fold()
• accumulate()
• repeats()
• map()
• peek()
• not()
• input()
• and_then()
• optional()

The sequence combinator is so common that it has a special form. Tuples of parsers implement Parser such that the tuple parser succeeds if all its parsers succeed.

Errors

parser-compose take a simple approach to error handling: If a parser fails, it returns None

Structs

AndThen

See and_then()

Byte

See byte

Fold

See fold()

Map

See map().

Optional

See optional()

Or

See or()

Peek

See peek()

Predicate

See when()

Utf8Scalar

See utf8_scalar

Traits

Parser

A trait for parsers

RepetitionArgument

Trait used to specify how many times a parser should run.

Functions

byte

Returns a parser that recognizes the first byte in a slice if its value is in the specified range.

first_slice_item

A parser that recognizes the first item in a slice.

first_utf8_scalar

A parser that recognizes the first unicode scalar value at the start of a string slice.

utf8_scalar

Returns a parser that recognizes the first unicode scalar value in a string slice if its value is in the specified range

Type Aliases

AccumulateInit

A Fold init function that uses a Vec as an accumulator

AccumulateOperation

A Fold operation function that uses a Vec as an accumulator

RepeatsInit

A Fold init function that does not use an accumulator.

RepeatsOperation

A Fold operation function that does nothing with what is given to it