package bjc.utils.parserutils; import java.util.Deque; import java.util.LinkedList; import java.util.function.Function; import java.util.function.Predicate; import bjc.data.IHolder; import bjc.data.IPair; import bjc.data.ITree; import bjc.data.Identity; import bjc.data.Pair; import bjc.funcdata.IList; /** * Creates a parse tree from a postfix expression. * * @author ben * */ public class TreeConstructor { /** * Alias interface for special operator types. * * @param * The token type of the tree. */ public interface QueueFlattener extends Function>, ITree> { /* * Alias */ } /* Alias for constructor state. */ static final class ConstructorState extends Pair>, ITree> { public ConstructorState(final Deque> left, final ITree right) { super(left, right); } public ConstructorState( final IPair>, ITree> par) { super(par.getLeft(), par.getRight()); } } /** * Construct a tree from a list of tokens in postfix notation. * * Only binary operators are accepted. * * @param * The elements of the parse tree. * * @param tokens * The list of tokens to build a tree from. * * @param isOperator * The predicate to use to determine if something is a * operator. * * @return A AST from the expression. */ public static ITree constructTree( final IList tokens, final Predicate isOperator) { /* Construct a tree with no special operators */ return constructTree(tokens, isOperator, op -> false, null); } /** * Construct a tree from a list of tokens in postfix notation. * * Only binary operators are accepted by default. Use the last two parameters to * handle non-binary operators. * * @param * The elements of the parse tree. * * @param tokens * The list of tokens to build a tree from. * * @param isOperator * The predicate to use to determine if something * is a operator. * * @param isSpecialOperator * The predicate to use to determine if an operator * needs special handling. * * @param handleSpecialOperator * The function to use to handle special case * operators. * * @return A AST from the expression. * */ public static ITree constructTree( final IList tokens, final Predicate isOperator, final Predicate isSpecialOperator, final Function> handleSpecialOperator) { /* * Make sure our parameters are valid */ if (tokens == null) throw new NullPointerException("Tokens must not be null"); else if (isOperator == null) throw new NullPointerException("Operator predicate must not be null"); else if (isSpecialOperator == null) throw new NullPointerException( "Special operator determiner must not be null"); final ConstructorState cstate = new ConstructorState<>(new LinkedList<>(), null); /* Here is the state for the tree construction */ final IHolder> initialState = new Identity<>(cstate); /* Transform each of the tokens */ final TokenTransformer trans = new TokenTransformer<>(initialState, isOperator, isSpecialOperator, handleSpecialOperator); tokens.forEach(trans); /* Grab the tree from the state */ return initialState.unwrap(ConstructorState::getRight); } }