.. _plugin-math:

The Math plugin
===============

.. _command-base:

base <fromBase> [<toBase>] <number>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Converts *<number>* from base *<fromBase>* to base *<toBase>*.
If *<toBase>* is left out, it converts to decimal.


.. _command-rpn:

rpn <rpn math expression>
^^^^^^^^^^^^^^^^^^^^^^^^^

Returns the value of an RPN expression.


.. _command-convert:

convert [<number>] <unit> to <other unit>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Converts from *<unit>* to *<other unit>*. If number isn't given, it
defaults to 1. For unit information, see 'units' command.


.. _command-icalc:

icalc <math expression>
^^^^^^^^^^^^^^^^^^^^^^^

This is the same as the calc command except that it allows integer
math, and can thus cause the bot to suck up CPU. Hence it requires
the 'trusted' capability to use.


.. _command-units:

units [<type>]
^^^^^^^^^^^^^^

With no arguments, returns a list of measurement types, which can be
passed as arguments. When called with a type as an argument, returns
the units of that type.


.. _command-calc:

calc <math expression>
^^^^^^^^^^^^^^^^^^^^^^

Returns the value of the evaluated *<math expression>*. The syntax is
Python syntax; the type of arithmetic is floating point. Floating
point arithmetic is used in order to prevent a user from being able to
crash to the bot with something like '10**10**10**10'. One consequence
is that large values such as '10**24' might not be exact.