Dice/RollerConfig - Revision history

Skizzerz: /* Remarks */

2018-12-23T18:03:53Z

Remarks

2018-12-23T17:45:11Z

Remarks

2018-12-23T17:44:27Z

Properties

2018-12-23T05:03:06Z

rm ExecuteMacro, no longer exists

2017-08-14T21:49:51Z

Thread Safety

2017-08-14T21:48:59Z

Thread Safety

2017-08-14T21:48:33Z

Thread Safety

2017-08-04T21:53:54Z

2017-08-04T21:26:17Z

Remarks

2017-08-04T21:25:53Z

Examples

@@ Line 51: / Line 51: @@
 FunctionRegistry.RegisterType(typeof(BuiltinFunctions));
 MacroRegistry = new MacroRegistry();
 RollDie = null; // null makes the default implementation generate random numbers (using GetRandomBytes below) to roll dice
 GetRandomBytes = null; // null makes use of System.Cryptography.RNGCryptoServiceProvider to generate random numbers

@@ Line 51: / Line 51: @@
 FunctionRegistry.RegisterType(typeof(BuiltinFunctions));
 MacroRegistry = new MacroRegistry();
 GetRandomBytes = null; // null makes use of System.Cryptography.RNGCryptoServiceProvider to generate random numbers
 MaxDice = 1000;

@@ Line 41: / Line 41: @@
 |-
 | {{public}} {{property}} || [[Dice/RollerConfig/NormalSidesOnly|NormalSidesOnly]] || Gets or sets whether dice expressions are limited to rolling dice with a "normal" number of sides, or if they can roll dice of any number of sides.
 |}

@@ Line 25: / Line 25: @@
 ! style="width: 5em" |
 ! Name !! Description
 |-
 | {{public}} {{property}} || [[Dice/RollerConfig/FunctionRegistry|FunctionRegistry]] || Gets or sets the registry of all valid function names and their callbacks.

@@ Line 60: / Line 60: @@
 == Thread Safety ==
-Reading values from RollerConfig is thread safe. Writing values or manipulating the FunctionRegistry or MacroRegistry is not thread-safe. Internal functions do not write to RollerConfig.
+Reading values from RollerConfig is thread safe. Writing values or manipulating the FunctionRegistry or MacroRegistry is not thread-safe. Internal functions do not write to RollerConfig. The default implementation of GetRandomBytes is thread-safe; passing your own version here may or may not be thread-safe.
 == Examples ==

@@ Line 48: / Line 48: @@
 The default values for RollerConfig are as follows. These values are set upon constructing the object, however they can be overridden by passing in different values when creating the object (see Examples below for details).
 <syntaxhighlight lang="C#">
 FunctionRegistry = new FunctionRegistry();
 FunctionRegistry.RegisterType(typeof(BuiltinFunctions));

@@ Line 75: / Line 75: @@
          var config = new RollerConfig()
+         {
-             ExecuteMacro = DoMacroStuff
+             MaxDice = 200
          };
+     }
+}
 </syntaxhighlight>