Skizzerz at 21:45, 14 August 2017

2017-08-14T21:45:07Z

Skizzerz: Created page with "{{APIdoc|DiceAST.Reroll Method (RollerConfig, DiceAST, Int32)}} Re-do the roll without re-evaluating the entire subtree again. {{ns}} == Syntax ==
2017-05-15T23:06:35Z

Created page with "{{APIdoc|DiceAST.Reroll Method (RollerConfig, DiceAST, Int32)}} Re-do the roll without re-evaluating the entire subtree again. {{ns}} == Syntax == <syntaxhighlight lang="C#"..."

New page
{{APIdoc|DiceAST.Reroll Method (RollerConfig, DiceAST, Int32)}}
Re-do the roll without re-evaluating the entire subtree again.

{{ns}}

== Syntax ==
<syntaxhighlight lang="C#">
protected internal long Reroll(
RollerConfig conf,
DiceAST root,
int depth
)
</syntaxhighlight>

=== Parameters ===
; ''conf''
: Type: [[Dice/RollerConfig|Dice.RollerConfig]]
: Configuration of the roller.

; ''root''
: Type: [[Dice/AST/DiceAST|Dice.AST.DiceAST]]
: Root of the AST.

; ''depth''
: Type: System.Int32
: Current recursion depth.

=== Return Value ===
Type: System.Int64

Total number of rolls taken to reroll this subtree.

== Remarks ==
This method is responsible for re-rolling and AST without re-evaluating every node, and tracks things like recursion depth and total number of rolls (throwing DiceException if they get too high). It calls [[../RerollInternal|RerollInternal]] to actually perform the evaluation logic (as this method is not virtual). If [[../Evaluated|Evaluated]] is {{cs|false}}, this will call [[../Evaluate|Evaluate]] instead.

Rerolls should re-perform the main evaluation logic without doing extra work. For example, in the dice expression {{c|(1d6)d4}}, first 1d6 is evaluated and then that many d4s are rolled. When rerolling that expression, the 1d6 is not re-evaluated; instead the prior value is kept and that many d4s are re-rolled.

When a subclass is inside of RerollInternal, it should call Reroll on any child nodes it has before executing its own logic. These calls should typically increase the depth by 1.

== See Also ==
The [[../Evaluate|Evaluate]] method has an example of a subclass of DiceAST implementing RerollInternal.

@@ Line 1: / Line 1: @@
-{{APIdoc|DiceAST.Reroll Method (RollerConfig, DiceAST, Int32)}}
+{{APIdoc|DiceAST.Reroll Method (RollData, DiceAST, Int32)}}
 Re-do the roll without re-evaluating the entire subtree again.
@@ Line 7: / Line 7: @@
 <syntaxhighlight lang="C#">
 protected internal long Reroll(
-     RollerConfig conf,
+     RollData data,
      DiceAST root,
      int depth
@@ Line 14: / Line 14: @@
 === Parameters ===
-; ''conf''
+; ''data''
-: Type: [[Dice/RollerConfig|Dice.RollerConfig]]
+: Type: {{l|Dice.RollData}}
-: Configuration of the roller.
+: Configuration of the roller and roll-specific data.
 ; ''root''