The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Games-Dice-0.044
River stage one • 2 direct dependents • 2 total dependents
2 ++
/ roll

NAME

roll - Command line interface for dice rolls

VERSION

version 0.044

SYNOPSIS

    # Evaluate these command line params
    roll 3d6 2d8

    echo "5d6" > f
    echo "2d4+1" >> f

    # Read the contents of 'f' from STDIN
    roll < f

    # Evaluate 1d100 and open file 'f'
    roll d% f

OVERVIEW

This is a command line interface to the Games::Dice library. It takes die rolling specifications in the form of adb[+-*/b]c.

(This specification may change a bit over time, but not radically.)

  • a is optional and defaults to 1; this is number of dice to roll.

  • b is the number of sides on each die. '%' is shorthand for 100.

The optional end modifies the sum of the rolls. 'b' means take the "best" c rolls and sum them. Also '/' truncates the result to an integer after division.

Dice specifications can be piped in, given on STDIN or as positional parameters from the command line.

If a positional parameter matches a file name, it will be opened and each line of the file evaluated.

AUTHORS

  • Philip Newton <pne@cpan.org>

  • Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 1999 by Philip Newton.

This is free software, licensed under:

  The MIT (X11) License