Dice/RollerConfig/MaxRecursionDepth - Revision history

Skizzerz at 18:57, 13 April 2017

2017-04-13T18:57:09Z

Skizzerz at 18:50, 10 April 2017

2017-04-10T18:50:31Z

Skizzerz: add graph

2017-04-10T18:42:48Z

add graph

Skizzerz: /* Remarks */

2017-04-10T18:31:55Z

Remarks

Skizzerz: Created page with "{{APIdoc|RollerConfig.MaxRecursionDepth Property}} Gets or sets how deeply nested a dice expression can get. {{ns}} == Syntax == public ushort Ma..."

2017-04-10T18:22:05Z

Created page with "{{APIdoc|RollerConfig.MaxRecursionDepth Property}} Gets or sets how deeply nested a dice expression can get. {{ns}} == Syntax == <syntaxhighlight lang="C#"> public ushort Ma..."

New page

{{APIdoc|RollerConfig.MaxRecursionDepth Property}}
Gets or sets how deeply nested a dice expression can get.

{{ns}}

== Syntax ==
<syntaxhighlight lang="C#">
public ushort MaxRecursionDepth { get; set; }
</syntaxhighlight>

=== Property Value ===
Type: System.UInt16

The maximum amount of nesting that can happen in dice expressions. Exceeding this limit will result in a [[Dice/DiceException|DiceException]] being thrown with DiceErrorCode.RecursionDepthExceeded.

== Remarks ==
The default value for MaxRecursionDepth is 20. It is recommended to not set this too high, but it should be high enough to handle complex rolls. For example, the dice expression {{c|floor((1d20rr<5dl1 + 2) * 1.5)}} has a depth of 5 (floor is at the top, then multiply, add, drop, reroll, roll). The topmost operation counts as depth 0 rather than depth 1 for the purposes of MaxRecusionDepth.

@@ Line 17: / Line 17: @@
 The default value for MaxRecursionDepth is 20. It is recommended to not set this too high, but it should be high enough to handle complex rolls. For example, the dice expression {{c|floor((1d20rr<5dl1 + 2) * 1.5)}} has a depth of 5 (see below for a representation of the abstract syntax tree). The topmost operation counts as depth 0 rather than depth 1 for the purposes of MaxRecusionDepth.
-<graphviz format="svg">
+<graphviz format="svg" caption="AST for above expression" desc="none">
 digraph AST {
 mult[label="*"]

← Older revision		Revision as of 18:42, 10 April 2017
Line 16:		Line 16:
	== Remarks ==		== Remarks ==
	The default value for MaxRecursionDepth is 20. It is recommended to not set this too high, but it should be high enough to handle complex rolls. For example, the dice expression {{c\|floor((1d20rr<5dl1 + 2) * 1.5)}} has a depth of 5 (see below for a representation of the abstract syntax tree). The topmost operation counts as depth 0 rather than depth 1 for the purposes of MaxRecusionDepth.		The default value for MaxRecursionDepth is 20. It is recommended to not set this too high, but it should be high enough to handle complex rolls. For example, the dice expression {{c\|floor((1d20rr<5dl1 + 2) * 1.5)}} has a depth of 5 (see below for a representation of the abstract syntax tree). The topmost operation counts as depth 0 rather than depth 1 for the purposes of MaxRecusionDepth.
		+
		+	<graphviz format="svg">
		+	digraph AST {
		+	mult[label="*"]
		+	add[label="+"]
		+	reroll[label="rr<5"]
		+	drop[label="dl1"]
		+	roll[label="1d20"]
		+	floor -> mult -> add -> drop -> reroll -> roll
		+	mult -> 1.5
		+	add -> 2
		+	}
		+	</graphviz>

← Older revision		Revision as of 18:31, 10 April 2017
Line 15:		Line 15:

	== Remarks ==		== Remarks ==
−	The default value for MaxRecursionDepth is 20. It is recommended to not set this too high, but it should be high enough to handle complex rolls. For example, the dice expression {{c\|floor((1d20rr<5dl1 + 2) * 1.5)}} has a depth of 5 (~~floor is at~~ the ~~top, then multiply, add, drop, reroll, roll~~). The topmost operation counts as depth 0 rather than depth 1 for the purposes of MaxRecusionDepth.	+	The default value for MaxRecursionDepth is 20. It is recommended to not set this too high, but it should be high enough to handle complex rolls. For example, the dice expression {{c\|floor((1d20rr<5dl1 + 2) * 1.5)}} has a depth of 5 (see below for a representation of the abstract syntax tree). The topmost operation counts as depth 0 rather than depth 1 for the purposes of MaxRecusionDepth.

@@ Line 6: / Line 6: @@
 == Syntax ==
 <syntaxhighlight lang="C#">
-public ushort MaxRecursionDepth { get; set; }
+public short MaxRecursionDepth { get; set; }
 </syntaxhighlight>
 === Property Value ===
-Type: System.UInt16
+Type: System.Int16
 The maximum amount of nesting that can happen in dice expressions. Exceeding this limit will result in a [[Dice/DiceException|DiceException]] being thrown with DiceErrorCode.RecursionDepthExceeded.