< Dice‎ | Roller

Difference between revisions of "Dice/Roller/Roll (String, RollerConfig)"

From DiceRoller Documentation
 
Line 35: Line 35:
  
 
When a DiceException is thrown, the exception will contain an ErrorCode property which describes the error in more detail.
 
When a DiceException is thrown, the exception will contain an ErrorCode property which describes the error in more detail.
 
== Example ==
 
<syntaxhighlight lang="C#">
 
RollResult result = Roller.Roll("1d20+4");
 
Console.WriteLine(result.Value);
 
</syntaxhighlight>
 

Latest revision as of 20:12, 23 December 2018

Rolls dice according to the given dice expression. Please see Dice Reference for more information about dice expressions.

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

Syntax

public static RollResult Roll(
    string diceExpr,
    RollerConfig config
)

Parameters

diceExpr
Type: System.String
A dice expression.
config
Type: Dice.RollerConfig
Configuration to use for this roll. If null, the DefaultConfig will be used.

Return value

Type: Dice.RollResult

The result of rolling diceExpr.

Exceptions

Exception Condition
ArgumentNullException diceExpr is null.
DiceException An error was detected with diceExpr.

When a DiceException is thrown, the exception will contain an ErrorCode property which describes the error in more detail.