Returns Euler's number *e* raised to the power of number.
Syntax
double|decimal exp(<number>)Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
number | Yes | DOUBLE or DECIMAL | The exponent. STRING and BIGINT inputs are implicitly converted to DOUBLE before the calculation. |
Return value
Returns a value of the DOUBLE or DECIMAL type.
| Input type | Return type |
|---|---|
| DOUBLE | DOUBLE |
| DECIMAL | DECIMAL |
| STRING or BIGINT | DOUBLE |
| null | null |
Examples
Static values
-- Returns 4.810477252069109
SELECT EXP(3.1415926/2);
-- Returns null
SELECT EXP(null);Table data
The following examples use the sample table mf_math_fun_t. Create the table and insert sample data:
CREATE TABLE IF NOT EXISTS mf_math_fun_t (
int_data INT,
bigint_data BIGINT,
double_data DOUBLE,
decimal_data DECIMAL,
float_data FLOAT,
string_data STRING
);
INSERT INTO mf_math_fun_t VALUES
(null, -10, 0.525, 0.525BD, cast(0.525 as float), '10'),
(-20, null, -0.1, -0.1BD, cast(-0.1 as float), '-10'),
(0, -1, null, 20.45BD, cast(-1 as float), '30'),
(-40, 4, 0.89, null, cast(0.89 as float), '-30'),
(5, -50, -1, -1BD, null, '50'),
(-60, 6, 1.5, 1.5BD, cast(1.5 as float), '-50'),
(-1, -70, -7.5, -7.5BD, cast(-7.5 as float), null),
(-80, 1, -10.2, -10.2BD, cast(-10.2 as float), '-1'),
(9, -90, 2.58, 2.58BD, cast(2.58 as float), '0'),
(-100, 10, -5.8, -5.8BD, cast(-5.8 as float), '-90');Query the sample data:
SELECT * FROM mf_math_fun_t;Result:
+------------+-------------+-------------+--------------+------------+-------------+
| int_data | bigint_data | double_data | decimal_data | float_data | string_data |
+------------+-------------+-------------+--------------+------------+-------------+
| NULL | -10 | 0.525 | 0.525 | 0.525 | 10 |
| -20 | NULL | -0.1 | -0.1 | -0.1 | -10 |
| 0 | -1 | NULL | 20.45 | -1.0 | 30 |
| -40 | 4 | 0.89 | NULL | 0.89 | -30 |
| 5 | -50 | -1.0 | -1 | NULL | 50 |
| -60 | 6 | 1.5 | 1.5 | 1.5 | -50 |
| -1 | -70 | -7.5 | -7.5 | -7.5 | NULL |
| -80 | 1 | -10.2 | -10.2 | -10.2 | -1 |
| 9 | -90 | 2.58 | 2.58 | 2.58 | 0 |
| -100 | 10 | -5.8 | -5.8 | -5.8 | -90 |
+------------+-------------+-------------+--------------+------------+-------------+Apply EXP to BIGINT, DOUBLE, DECIMAL, and STRING columns:
SELECT
EXP(bigint_data) AS bigint_new,
EXP(double_data) AS double_new,
EXP(decimal_data) AS decimal_new,
EXP(string_data) AS string_new
FROM mf_math_fun_t;Result:
+-------------------------+-------------------------+-------------------------+-------------------------+
| bigint_new | double_new | decimal_new | string_new |
+-------------------------+-------------------------+-------------------------+-------------------------+
| 0.000045399929762484854 | 1.6904588483790914 | 1.6904588483790914 | 22026.465794806718 |
| NULL | 0.9048374180359595 | 0.9048374180359595 | 0.000045399929762484854 |
| 0.36787944117144233 | NULL | 760890487.9368925 | 10686474581524.463 |
| 54.598150033144236 | 2.4351296512898744 | NULL | 9.357622968840175e-14 |
| 1.9287498479639178e-22 | 0.36787944117144233 | 0.36787944117144233 | 5.184705528587072e21 |
| 403.4287934927351 | 4.4816890703380645 | 4.4816890703380645 | 1.9287498479639178e-22 |
| 3.975449735908647e-31 | 0.0005530843701478336 | 0.0005530843701478336 | NULL |
| 2.718281828459045 | 0.000037170318684126734 | 0.000037170318684126734 | 0.36787944117144233 |
| 8.194012623990515e-40 | 13.197138159658358 | 13.197138159658358 | 1.0 |
| 22026.465794806718 | 0.0030275547453758153 | 0.0030275547453758153 | 8.194012623990515e-40 |
+-------------------------+-------------------------+-------------------------+-------------------------+Rows where the input column is null return NULL in the corresponding output column. STRING inputs are parsed as numeric values before the calculation is applied.
Related functions
EXP is a mathematical function. For more information about related functions, see Mathematical functions.