README

Sey

Sey, pronounce say, is a powerful math interpreter with arbitrary-precision.

Requires PHP 8.0.0+ and the bcmath extension

You can install the package via composer:

composer require felixdorn/sey

Sey::parse('(0.5 + 0.5) / 3)'); // 0.3333333333333333
// or
sey('a / b', ['a' => 1, 'b' => 2]); // 0.5

By default, the maximum floating precision is 16.

You may change it:

\Felix\Sey\Sey:precision(32);

It's just math.

1 + 2
2 - 3
3 * 4
4 / 5
5 % 6
6 ^ 7
7 * (8 + 9)
sqrt(10)
powmod(11)
11(12 - 13)
(14 + 15)^16
!(5)
pi()

You can not define variables in your code but you can pass them at compile-time.

Sey::parse('2 * r * pi', [
    'r' => 10,
    'pi' => 3.1415
]);

sqrt: bcsqrt
powmod: bcpowmod
pi(): custom bcpi function

This function returns pi with your defined precision up to 999 digits.
!(n): custom bcfact function

This computes n!, if you need to do it really quickly, you should probably use a lookup table.

You can override built-ins functions.

Sey::define('!', function (int $n, /* as many arguments as you want */) {
    return $factorials[$n] ?? bcfact($n);
});

The function name must match the following regex [a-z_A-Z!]+[a-z_A-Z0-9]*.

So, first character must be a letter or ! followed by any number of letters or numbers.

composer test

sey was created by Félix Dorn under the MIT license.