Expand description

Parsers for various ROM naming conventions.

Zero-copy guarantee

All parsers are zero-copy but may allocate. Tokens returned are slices of the input string.

Order significance

The order of returned tokens in a name is significant in order of appearance in the input file name, and tokens are not guaranteed to have consistent semantics outside of a parsed name.

Runtime analysis

Because of ambiguities in conventions of each parser type, lookaheads are unavoidable and thus each parser has a quadratic worse-case runtime, in the length of the string. This is acceptable for small inputs such as the file names of catalogued ROM files.

The zero-copy guarantee should ensure that parsing is sufficiently fast for large numbers of inputs.

Modules

Parsers for the GoodTools naming convention.

Parsers for the No-Intro naming convention.

Parsers for the TOSEC naming convention.

Enums

The type of generic flag that appears in a catalogued file name.

Name parsing errors.

Naming convention commonly used by DAT producers.

Traits

A name that is tokenized according to some naming convention.