DiceLord PHP intro

/*
 * DiceLord (diceLord) is a roll notation and execution library for PHP. It is intended to be included or required.
 * a diceLord object is necessary, but the class really is only accessed for functions and each object doesn't store any data other than the functions it has.
 * While DiceLord was created for RollDB, it is designed to be used anywhere a RNG is needed, so by default it returns a number.
 *
 * While using DiceLord, it is a good idea to abstain from prefixing any methods with "diceLord" unless they are intended to integrate with DiceLord.
 * DiceLord also uses $_GLOBALS['dlText'] when dlExecute is called, which may cause issues.
 *
 * DiceLord has two means of output:
 * Returning the dlExecute(input) function will give you the final numerical outcome in the form of either successes or a sum of dice.
 * dlExecute also creates $dlText; assigning null or "null" to the second operator of the function will prevent this from happening, or you can change the variable name to $foo by putting "foo" in the second operator.
 *
 * Two of the design goals for DiceLord are to be human legible (without regular expressions), and to support an insane number of features to support basically all random number generation functions.
 * DiceLord is also case sensitive.
 *
 * DiceLord looks at pools of dice, with a simple notation involving commands (which can be Dice, Diemods, and pre-Operations, Operations, and post-Operations).
 * Pools are written separated by a semicolon, with each command in a pool separated via commas.
 *
 * Note that any time you see a # in the documentation, it is a standin for an integer; as are x, y, and z. "x"/"y"/"z" is a standin for a string.
 *
 * The following are mechanisms that DiceLord supports:
 *
 * Dice:
 * Dice are the individual components sent to the random number generator.
 * Traditional dice only require the letter in their notation and enough content to know what to roll; dy will result in 1dy, f will result in 4f+0, c will result in 1c.
 * Advanced "dice", which are actually stages or multiple dice referenced by a chart (such as Earthdawn's steps), cannot be used without both x and "y" input, where "y" is a string.
 *
 * xdy+z (x dice with y sides, modifying the result by z) [result of 1-y]
 * xf+z (x Fate dice, modifying the result by z) [result of -1, 0, or 1]
 * xc+z (x cointosses, modifying the result by z) [result of 0 or 1]
 * xs"y" (x steps/stages of "y" type) [takes from $"y" in $dlconfig.php] {special rules apply to stage/step notation}
 * xm"y" (x according to "y" method) [takes from result of "y"(x) in $dlmethods.php] {runs a function to calculate steps/stages/etc, diceLord is appended automatically to the front of "y"}
 *
 * Diemods:
 * Diemods are applied to all dice in a pool, and may impact the way that things are interpreted.
 * This means that in an xdy roll, the diemod would be applied x times.
 * Diemods all look at particular dice; once the results of a pool's rolls are completed diemods go back over the results and see if things happen.
 * Diemods are used before pre-Operations, and rolls can happen as a result of diemods.
 * Diemods are all suffixed with a diemod suffix, which is a number, and optionally a greater than or lesser than sign (all diemods) and some diemod specific suffixes (such as i/o for explosions).
 *
 * X for exploding dice. By default, an explosion increases the value of the original die. Adding "i" creates an inert outward explosion (new die is rolled that is not subject to explosion, but potentially to other diemods), while adding "o" creates an outward exploded die that is subject to exploding again. (X6 means results of 6 explode)
 * G for glitches; glitches are an additional result added to the $poolStr. (G<2 would mean any number below 2 glitches)
 * D for drop; this removes all dice with a certain result. (D1 would mean that results of 1 are removed, D<3 means all results of 3 and less are removed)
 * R for reroll; results of R are rerolled. This is recursive, though R is set up not to infinite loop (if R is greater than y in xdy or 1 for xf or xc it'll terminate).
 *
 * Pre-Operations:
 * Pre-Operations manipulate the pool prior to the Operation. You can have multiple, but they always execute in order of H-L-!, so keep that in mind.
 *
 * H# to keep highest # dice. H6 will keep the six highest individual results, so if you rolled 8d20, you'd get the six highest d20's from that result. Affix r to drop highest # dice.
 * L# to keep lowest # dice. L2 keeps the two lowest dice. Affix r to drop lowest # dice and keep the rest.
 * ! removes dice when a number is met; it will remove either the highest die (!#h), the lowest die (!#l), or a specific number when you put in something. (!1h will remove the highest die in the pool for each one that comes up).
 *
 * A complex pre-Operation would be H5, L2, !3, which would keep the lowest two of the highest five dice, and then remove any results of 3. !3, H5, L2; L2, !3, H5; or any combination of ordering will have the same result.
 *
 * Operations:
 * An Operation is an exclusive element; if you include multiple Operations in your DiceLord prompt, you'll only have one performed.
 * The default Operation is set in dlconfig.php, as are any list outcomes.
 *
 * I for individual results (each section of dice is rolled and reported independently (e.g. [d20,d6,I] results in "1-20, 1-6").
 * S for a sum (each section of dice is rolled indepdently, but added prior to reporting (e.g. [d20,d6,S] results in "2-26"). Note that if a cointoss or Fate roll has been done, this gets special notice.
 * # for success on a certain result (each section of dice has its result reported independently); >/< suffixes work as they do on diemods.
 *
 *
 * Post-Operations:
 * Post-Operations follow Operations, and are only valid if certain Operations are performed (
 *
 * ! can be a post operation when written as !# without a "h" or "l" suffix. If this is done it removes a success from the pool for each result of #. So !# would remove one success for every 1 met. You can have multiple !# of the same number (ex. !1, !1) to remove multiple successes for each result.
 *
 */