C#

CongoCC generates a ready-to-build C# project from the same grammar used for any other target, provided the grammar’s embedded code (if any) is C# or is guarded for C# (Injected Code Across Languages).

Output layout

The output is a project directory named cs- plus the last component of PARSER_PACKAGE plus parser — demo.lang becomes cs-langparser/ — containing a .csproj (named after the full package) and the generated sources:

cs-langparser/
├── demo.lang.csproj
├── Lexer.cs
├── Parser.cs
├── Tokens.cs
└── Utils.cs

The generated code uses the full PARSER_PACKAGE as its namespace.

Using the parser

The API follows C# conventions: a constructor taking the input, production methods that are Parse-prefixed and PascalCase, and RootNode as a property rather than a method:

var parser = new Parser(input);
parser.ParseNumberList();
Node root = parser.RootNode;

ParseException derives from System.Exception.

The preprocessor on the C# target

CongoCC’s own grammar preprocessor (#if and friends, The Grammar File) works for every target, but when generating C# its #define and #undef directives must appear before the first real token of the grammar file, matching C#’s own rule for those directives. Place any such definitions at the very top.

Runtime

Build with dotnet build against the generated .csproj. Generated parsers need only the .NET standard library; there is no package to add.