//==============================================================================
// tribble/io/ParserWithParseTreeI.java
//------------------------------------------------------------------------------

package tribble.io;


// System imports

import java.lang.Exception;
import java.lang.String;


// Local imports

import tribble.io.ParserI;
import tribble.io.ParseTreeI;


/*******************************************************************************
* Generic parser interface.
*
* <p>
* This interface is used to implement any kind of parser which reads tokens
* from an input source stream (implementing the {@link LexerI} interface) and
* produces a syntax parse tree (implementing the {@link ParseTreeI} interface).
*
* @version	$Revision: 1.1 $ $Date: 2001/05/12 20:34:17 $
* @since	2001-05-12
* @author
*	David R. Tribble,
*	<a href="mailto:david@tribble.com">david@tribble.com</a>
*	<br>
*	<a href="../Copyright.html">Copyright</a>
*	©2001-2002 by David R. Tribble, all rights reserved.
*	<br>
*	Permission is granted to freely use and distribute this source code
*	provided that the original copyright and authorship notices remain
*	intact.
*
* @see	ParserI
* @see	ParseTreeI
*/

public interface ParserWithParseTreeI
    extends ParserI
{
// Identification

    /** Revision information. */
    static final String		REV =
        "@(#)tribble/io/ParserWithParseTreeI.java $Revision: 1.1 $ $Date: 2001/05/12 20:34:17 $\n";


// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
// Public methods

    /***************************************************************************
    * Retrieves the parse tree that resulted from a successful parsing of the
    * input token stream.
    *
    * @return
    * The parse tree resulting from the parsing of the input token stream, or
    * null if there is no tree or an error occurred during parsing.
    *
    * @since	1.1, 2001-05-12
    */

    public ParseTreeI getParseTree();
}

// End ParserWithParseTreeI.java