...

• #Architecture
• #Status
  • #Version 3.0.x
  • #Version 3.1.x
• #Target Platforms
  • #CSharp target (versions 3.0.x and 3.1.x only)
  • #CSharp2 target (version 3.1.x and later)
  • #Runtime Location
  • #Supported build tools
• #Performance
• #Usage
  • #Generating #Specify that C# code from should be generated for a grammar#Specifying the
  • #List of generated C# source files
  • #Specify a C# namespace for your recognizer
  • #Members blocks vs C# v2 Partial Classes
  • #Syntactic differences from the Java target
  • #Debugging with ANTLRWorks

...

The V3 target generates code that is easily faster than that generated by the V2 target (especially the lexers). We probably won't be able to match the bare-metal performance of the code generated by Jim Idle's C target or Ric Klaren's C++ target, but we expect to be very competitive with the other targets.

Usage

...

This section is NOT a tutorial on how to use either C# or ANTLR v3.x. It assumes that you are familiar with the concepts involved in developing ANTLR v3.x grammars and, in building and using C# programs and assemblies.

Specify that C# code should be generated for a grammar

To specify that the ANTLR tool should generate C# code (rather than the default of generating Java code) for a grammar, set the grammar-level option named language to the value CSharp2 (or CSharp for ANTLR version v3.0.x) as shown below:

grammar MyGrammar;

options
{
    language=CSharp2;
}

// rest of grammar follows
....

For the example grammar named MyGrammar above, the grammar file would typically be named MyGrammar.g. The grammar filename (excluding the extension) must match the grammar name as declared with the grammar directive in the file.

...

List of generated C# source files

For an example grammar named MyGrammar, the following table list the files that would be generated by ANTLR using the CSharp2 (and CSharp) target.

grammar MyGrammar;

options
{
    language=CSharp2;
}
// rest of grammar follows
....

lexer grammar MyGrammar;

options
{
    language=CSharp2;
}
// rest of grammar follows
....

parser grammar MyGrammar;

options
{
    language=CSharp2;
}
// rest of grammar follows
....

tree grammar MyGrammar;

options
{
    language=CSharp2;
}
// rest of grammar follows
....

Specify a C# namespace for your recognizer

You can specify that your generated recognizer should be declared within a specific namespace as shown below. By default all recognizers are generated as top-level types with no enclosing namespace.

...

...