package bjc.pratt.commands;

import bjc.pratt.ParserContext;
import bjc.pratt.tokens.Token;
import bjc.utils.parserutils.ParserException;

/**
 * Represents an initial command in parsing.
 *
 * @author EVE
 *
 * @param <K>
 *        The key type for the tokens.
 *
 * @param <V>
 *        The value type for the tokens.
 *
 * @param <C>
 *        The state type of the parser.
 *
 *
 */
@FunctionalInterface
public interface InitialCommand<K, V, C> {
	/**
	 * Construct the null denotation of this command.
	 *
	 * @param operator
	 *        The operator for this command.
	 * @param ctx
	 *        The context for the command.
	 *
	 * @return The result of executing the command.
	 *
	 * @throws ParserException
	 *         If something goes wrong during parsing.
	 */
	CommandResult<K, V> denote(Token<K, V> operator, ParserContext<K, V, C> ctx) throws ParserException;
}