Parsing Infix Expressions

Introduction

This assignment will give you practice with Java, interfaces (not Java interfaces, but the more general notion), and build tools (ant, jar).

You will create a calculator in Java that parses an infix expression into postfix, and then evaluates it.

You will use ant to build your program.


The Assignment

You will write a program that parses infix expressions (described below) into appropriate Tokens (operator or operand), stored in some linear container (ArrayList ?), passes the infix expression to a function that returns the expression to postfix form, then passes it to a function which evaluates the postfix expression, returns an integer.

We'll be doing only integer arithmetic. No float types. Also, though the inputs are positive, the intermediate results might not be.

The operators you will encounter are +, -, *, /, % (modulus). You must also be prepared to handle parenthesis.

Your code will be documented properly.

All will be done through an ant file.

I will also run Javadoc; I expect to get something useful out.


Your code

I expect to see, at a minimum, 2 methods:

I've written Token classes for you (the files are in this directory). You do need to fill in the Operator.getPrec() method, assign appropriate (relative) precedences to the operators.

The 2 types, Operand and Operator share a base class, Token, so that you can store an entire expression, in a generic ArrayList which holds Tokens. We need to get used to generics. Sample.java, in the directory, shows the creation and storage of various Tokens in a generic collection.

opType is an example of how we did "enums" pre- Java 1.5. Note that you can make these types smarter by assigning precedence right there. You're welcome to make this modification.

Yes, you need to use my Token classes.


Input

Your program will read a file called input.infix that contains a number of expressions, one per line.

Each line has, at most, 80 characters. Tokens will be separated by white space. Operands will be strictly non-negative integers. Operators are: { + - * / % } for addition, subtraction, multiplication, division, and modulus, respectively.

Here is a sample input:

13 + 23 - 42 * 2
3 * ( 5 - 2 ) % 5

A sample input file can be found here.

For my part, I promise that all expressions are valid.


Output

Your program will output, for each input expression, on one line:

postfix expression = result

, where result is the value of expression.

There will be one expression per line (same as the input). Single-space only, please.

So, given the input, above, I'd expect the output to be:

13 23 + 42 2 * - = -48
3 5 2 - * 5 % = 4

Documentation

I am NOT looking for a lot of comments here. Remember, your code should read like a book. But, each class should have a description, and each method should have a description and a discussion of inputs, side-effects, etc.

You will use Javadoc-style comments. HTML documentation will be created from your code, using ant (and javadoc, of course).

The HTML files will end up in a subdirectory of your source dir (which is also the CWD) called docs/.

See CS265/Labs/Java/Javadoc/ for an example.


Ant

You will include a build.xml that has, at a minimum, the following targets:

Note, since you're supplying build.xml, the names for the rest of the code doesn't matter. You can have 1 class, or 18 (though, that is probably overkill). The filenames don't matter to me (that is, they should be good names, but I don't need to know them ahead of time).


Algorithms

Infix to Postfix

Evaluating Postfix Expressions

Continue until you've reached the end of the expression. There should be exactly one element in the stack; the result of the expression.

The main function will parse the input file and hand the expressions to this function to evaluate. See the StreamTokenizer examples. Or, since the Java community is moving away from this, you might look at the String.split methods.


Submission

If you supply input.infix it will be overwritten.

Please note You will use the filenames as listed here, and submit them all to the proper assignment. If this is not clear, then see me in class. If I get programs submitted to the wrong directories, I will be irate, which may, in some subconscious way, affect your grades. Adversely.