clex

README

clex

A fully standards-compliant C11 positional lexer with error reporting.

The lexer reports errors with (1) a message, (2) the line so far, and (3) the position of the occurence, so that end-user messages can be produced such as:

test.c:20:33: Expected 4 hexadecimal characters for universal character name
    const char* s = "Hello \u042
--------------------------------^

Example Output

Executing clex test.c test.lexemes on:

extern int puts(const char *str)

int main(int argc, char **argv) {
        puts("Hello, world!");
}

Produces:

Keyword{extern}Whitespace{ }Keyword{int}Whitespace{ }Identifier{puts}LeftParenthesis{(}
Keyword{const}Whitespace{ }Keyword{char}Whitespace{ }Star{*}Identifier{str}RightParenthesis{)}
...

Future Plans

• Add a preprocessor
• Disambiguate integer and floating point constants into their proper sizes
• Support GCC extensions (if any modifications are necessary)
• Document the code