/**
 * This interface defines the basic notion of a token, including methods for
 * retrieving the raw token string and a token type field.
 * <p>
 * <b><em>Note:</em></b> The use of integers to represent token types is
 * fairly unsophisticated and not type safe.  A safe enum class would be
 * better, and hopefully in Java 1.5, Javasoft will see fit to provide a
 * first-class enum type.  Until then, it's large overhead to hack one
 * together, so I'm skipping it and going with the simple, suboptimal
 * solution.
 *
 * @author Terran Lane
 * @version 1.0
 */

public interface Token {
  /**
   * Retrieve the String representation of the token.
   *
   * @return The raw character string of the token.
   */
  public String getTokStr();

  /**
   * Retrieve a code representing the token type.  The specific values and
   * semantics of the character codes are defined by deriving classes and
   * the related lexer/parsers.
   *
   * @return Token type code.
   */
  public int getTokType();
}