//==============================================================================
// tribble/io/ParserWithSymbolTableI.java
//------------------------------------------------------------------------------

package tribble.io;


// System imports

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


// Local imports

import tribble.io.ParserI;
import tribble.io.SymbolTableI;


/*******************************************************************************
* 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 symbol table (implementing the {@link SymbolTableI} interface).
*
* @version	$Revision: 1.1 $ $Date: 2001/05/12 20:36:00 $
* @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	SymbolTableI
*/

public interface ParserWithSymbolTableI
    extends ParserI
{
// Identification

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


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

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

    public SymbolTableI getSymbolTable();
}

// End ParserWithSymbolTableI.java