< Dice‎ | AST

DiceAST Class

From DiceRoller Documentation

Represents a node in the dice expression Abstract Syntax Tree.

  • Namespace: Dice.AST
  • Assembly: DiceRoller (in DiceRoller.dll)

Inheritance Hierarchy

System.Object

Dice.AST.DiceAST

Syntax

public abstract class DiceAST

Methods

Name Description
Evaluate(RollerConfig, DiceAST, Int32) Evaluates the node, causing it to store its result in Value.
EvaluateInternal(RollerConfig, DiceAST, Int32) Actual evaluation logic, implemented by each subclass.
GetUnderlyingRollNode() Gets the roll node underneath this node, unless this node is a roll node of some sort.
Reroll(RollerConfig, DiceAST, Int32) Re-do the roll without re-evaluating the entire subtree again.
RerollInternal(RollerConfig, DiceAST, Int32) Actual reroll logic, implemented by each subclass.
ToString() Retrieves a normalized representation of the dice expression.

Properties

Name Description
Evaluated Gets whether or not this node has been evaluated.
Value Gets the final value of the node.
Values Gets the underlying dice that were rolled, as well as their values.
ValueType Gets what type of value we have (total or successes).

Remarks

The DiceAST class and its subclasses implement the AST from the parser. As it is not possible to extend the parser outside of the assembly, it does not make sense to make any additional subclasses of DiceAST. As such, the public API for DiceAST and its descendants are only its public methods and properties. Protected methods are considered to be part of the internal API and can change without warning even across minor or patch versions (unlike for other classes, where protected members are considered part of the public API).