113 lines
4.5 KiB
C#
113 lines
4.5 KiB
C#
/*
|
|
* [The "BSD licence"]
|
|
* Copyright (c) 2011 Terence Parr
|
|
* All rights reserved.
|
|
*
|
|
* Conversion to C#:
|
|
* Copyright (c) 2011 Sam Harwell, Pixel Mine, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. The name of the author may not be used to endorse or promote products
|
|
* derived from this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
namespace Antlr.Runtime.Tree
|
|
{
|
|
|
|
/** <summary>
|
|
* A TreeAdaptor that works with any Tree implementation. It provides
|
|
* really just factory methods; all the work is done by BaseTreeAdaptor.
|
|
* If you would like to have different tokens created than ClassicToken
|
|
* objects, you need to override this and then set the parser tree adaptor to
|
|
* use your subclass.
|
|
* </summary>
|
|
*
|
|
* <remarks>
|
|
* To get your parser to build nodes of a different type, override
|
|
* create(Token), errorNode(), and to be safe, YourTreeClass.dupNode().
|
|
* dupNode is called to duplicate nodes during rewrite operations.
|
|
* </remarks>
|
|
*/
|
|
public class CommonTreeAdaptor : BaseTreeAdaptor
|
|
{
|
|
public override object Create( IToken payload )
|
|
{
|
|
return new CommonTree( payload );
|
|
}
|
|
|
|
/** <summary>
|
|
* Tell me how to create a token for use with imaginary token nodes.
|
|
* For example, there is probably no input symbol associated with imaginary
|
|
* token DECL, but you need to create it as a payload or whatever for
|
|
* the DECL node as in ^(DECL type ID).
|
|
* </summary>
|
|
*
|
|
* <remarks>
|
|
* If you care what the token payload objects' type is, you should
|
|
* override this method and any other createToken variant.
|
|
* </remarks>
|
|
*/
|
|
public override IToken CreateToken( int tokenType, string text )
|
|
{
|
|
return new CommonToken( tokenType, text );
|
|
}
|
|
|
|
/** <summary>
|
|
* Tell me how to create a token for use with imaginary token nodes.
|
|
* For example, there is probably no input symbol associated with imaginary
|
|
* token DECL, but you need to create it as a payload or whatever for
|
|
* the DECL node as in ^(DECL type ID).
|
|
* </summary>
|
|
*
|
|
* <remarks>
|
|
* This is a variant of createToken where the new token is derived from
|
|
* an actual real input token. Typically this is for converting '{'
|
|
* tokens to BLOCK etc... You'll see
|
|
*
|
|
* r : lc='{' ID+ '}' -> ^(BLOCK[$lc] ID+) ;
|
|
*
|
|
* If you care what the token payload objects' type is, you should
|
|
* override this method and any other createToken variant.
|
|
* </remarks>
|
|
*/
|
|
public override IToken CreateToken( IToken fromToken )
|
|
{
|
|
return new CommonToken( fromToken );
|
|
}
|
|
|
|
/** <summary>
|
|
* What is the Token associated with this node? If
|
|
* you are not using CommonTree, then you must
|
|
* override this in your own adaptor.
|
|
* </summary>
|
|
*/
|
|
public override IToken GetToken( object t )
|
|
{
|
|
if ( t is CommonTree )
|
|
{
|
|
return ( (CommonTree)t ).Token;
|
|
}
|
|
return null; // no idea what to do
|
|
}
|
|
}
|
|
}
|