summaryrefslogtreecommitdiff
path: root/dice-lang/src/bjc/dicelang/IDiceExpression.java
blob: 9d29960bdf7721d536348e4c44dc08e4cf93f70f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
package bjc.dicelang;

import bjc.utils.funcutils.StringUtils;

/**
 * An expression for something that can be rolled like a polyhedral die
 * 
 * @author ben
 *
 */
@FunctionalInterface
public interface IDiceExpression {
	/**
	 * Parse a string into an expression.
	 * 
	 * It can accept the following types of expressions
	 * <ul>
	 * <li>Simple integers - '2'</li>
	 * <li>Simple dice - 'd6'</li>
	 * <li>Groups of simple dice - '2d6'</li>
	 * <li>Number concatenation - '2c6'</li>
	 * <li>Dice concatenation - '1d10c1d10</li>
	 * </ul>
	 * 
	 * Dice concatenation is like using 2 d10s to emulate a d100, so
	 * instead of adding them, it reads them side by side.
	 * 
	 * @param expression
	 *            The string to convert to an expression
	 * 
	 * @return The string, converted into expression form
	 */
	static IDiceExpression toExpression(String expression) {
		String literalData = expression;

		String diceMatcher = "\\Ad\\d+\\Z";

		if (StringUtils.containsInfixOperator(literalData, "c")) {
			// Parse a compound die
			String[] strangs = literalData.split("c");

			return new CompoundDice(strangs);
		} else if (StringUtils.containsInfixOperator(literalData, "d")) {
			// Handle groups of similiar dice
			return ComplexDice.fromString(literalData);
		} else if (literalData.matches(diceMatcher)) {
			// Handle people who put 'd6' instead of '1d6'
			return new Die(Integer.parseInt(literalData.substring(1)));
		} else {
			// Parse a scalar number
			try {
				return new ScalarDie(Integer.parseInt(literalData));
			} catch (NumberFormatException nfex) {
				UnsupportedOperationException usex = new UnsupportedOperationException(
						"Found malformed leaf token " + expression + ". Floating point numbers " +
						"are not supported.");

				usex.initCause(nfex);

				throw usex;
			}
		}
	}

	/**
	 * Check if this expression can be optimized to a scalar value
	 * 
	 * @return Whether or not this expression can be optimized to a scalar
	 *         value
	 */
	public default boolean canOptimize() {
		return false;
	}

	/**
	 * Optimize this expression to a scalar value
	 * 
	 * @return This expression, optimized to a scalar value
	 * 
	 * @throws UnsupportedOperationException
	 *             if this type of expression can't be optimized
	 */
	public default int optimize() {
		throw new UnsupportedOperationException(
				"Can't optimize this type of expression");
	}

	/**
	 * Roll the dice once
	 * 
	 * @return The result of rowing the dice
	 */
	public int roll();
}