The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

# NAME

Math::Bacovia::Power - Represents a symbolic exponentiation in a symbolic base.

# SYNOPSIS

``````    use 5.014;
use Math::Bacovia qw(Power Symbol);

my \$f = Power(Symbol('a'), Symbol('b'));
my \$g = Power(Symbol('x'), Symbol('y'));

say ((\$f + \$g)->pretty);    #=> (a^b + x^y)``````

# METHODS

This section describes the methods provided by the Math::Bacovia::Power module.

## new

``    my \$obj = Math::Bacovia::Power->new(\$base, \$exponent);``

Constructs and returns a new Math::Bacovia::Power object.

## get

``    my (\$base, \$exponent) = \$obj->get;``

Returns the internal values of the self-object.

## mul

``````    \$x * \$y
\$x->mul(\$y)``````

Product of `x` and `y`.

When the base of `x` and `y` are symbolically equivalent, the following identity is used:

``    a^b * a^c = a^(b + c)``

## div

``````    \$x / \$y
\$x->div(\$y)``````

Division of `x` by `y`.

When the base of `x` and `y` are symbolically equivalent, the following identity is used:

``    a^b / a^c = a^(b - c)``

## inv

``    \$x->inv``

Multiplicative inverse of `x`, using the indentity:

``    1/a^b = a^(-b)``

## eq

``````    \$x == \$y
\$x->eq(\$y)``````

Return a true value when `x` and `y` are symbolically equal.

# SPECIAL METHODS

This section describes the special methods provided by the Math::Bacovia::Power module.

## alternatives

``````    my @alt = \$obj->alternatives;
my @alt = \$obj->alternatives(full => 1);``````

This method uses common mathematical identities to create symbolically equivalent expressions from the self-expression.

## pretty

``    my \$str = \$obj->pretty;``

Returns a human-readable stringification of the self-expression.

## stringify

``    my \$str = \$obj->stringify;``

Returns a stringification of the self-expression.

## numeric

``    my \$num = \$obj->numeric;``

Evaluates the self-expression numerically and returns a Math::AnyNum object.

The other parts of Math::Bacovia:

# AUTHOR

Daniel Șuteu, `<trizen at protonmail.com>`

# BUGS

Please report any bugs or feature requests to https://github.com/trizen/Math-Bacovia. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

# SUPPORT

You can find documentation for this module with the perldoc command.

``    perldoc Math::Bacovia::Power``

You can also look for information at:

This program is free software; you can redistribute it and/or modify it under the terms of the the Artistic License (2.0). You may obtain a copy of the full license at: