🧮 CLI Calculator: Expression Evaluator
This is a command-line calculator that evaluates complex math expressions. It supports arithmetic, functions, constants, factorial, exponentiation, and more.
Single expression mode (evaluate and exit):
$ ./CalcX " x = 2 + 3 * (4 + sin(pi/2))" " y = cos(25pi * e)" " z=x+y"
17
0.990908748684919434565983548310094
17.990908748684919434565983548310094
REPL mode (no argument = interactive prompt):
./CalcX
>>> 1 + 2
3
>>> sin(tau) == 0
1
Decimal numbers : 1, 3.14, .5
Negative numbers : -5, -sqrt(4)
Operator
Meaning
Example
+
Addition
2 + 3, +1
-
Subtraction / Negate
5 - 2, -3
*
Multiplication
2 * 4
/
Division
8 / 2
^
Exponentiation
2 ^ 3 = 8
%
Modulo
10 % 3 = 1
!
Factorial
5! = 120
!!
Chained factorial
5!! = factorial(factorial(5))
|x|
Absolute value
|-3| = 3
=
Assignment (returns value)
x = y = pi * e
==
Equality comparison
pi == 3 == 0
!=
Inequality comparison
x != 25
>
Greater than
3 > 4 > 1 same as (3 > 4) > 1
>=
Greater than or equal
e >= 2
<
Less than
(x = sin(25pi)) > 0
<=
Less than or equal
pi^2 <= e^3
🔹 Implicit Multiplication
You can omit * in common cases:
Expression
Interpreted as
2pi
2 * pi
3(1 + 2)
3 * (1 + 2)
2sin(pi/2)
2 * sin(pi/2)
Name
Value
Description
pi
3.141592653589793
Ratio of a circle’s circumference to its diameter
e
2.718281828459045
Euler’s number (base of natural logarithm)
tau
6.283185307179586
Equal to 2 * pi; represents a full turn in radians
phi
1.618033988749895
Golden ratio: (1 + sqrt(5)) / 2
deg
0.017453292519943295
Radians per degree: pi / 180 (use to convert degrees → radians)
rad
57.29577951308232
Degrees per radian: 180 / pi (use to convert radians → degrees)
c
299792458.0
Speed of light in m/s
na
6.02214076e23
Avogadro number in 1/mol
ans
(last result)
Value of the previous expression result. Useful for chained calculations
🔸 Trigonometric Functions
Function(s)
Description
Example
sin(x)
Sine of angle x (in radians)
sin(pi / 2) = 1
cos(x)
Cosine of angle x (in radians)
cos(0) = 1
tan(x)
Tangent of angle x (in radians)
tan(pi / 4) = 1
asin(x), arcsin(x)
Inverse sine — returns angle (in radians)
asin(1) = pi / 2
acos(x), arccos(x)
Inverse cosine
acos(1) = 0
atan(x), arctan(x)
Inverse tangent
atan(1) = pi / 4
atan2(y, x), arctan2(y, x)
Inverse tangent of y/x considering quadrant
atan2(1, 1) = pi / 4
Function(s)
Description
Example
sinh(x)
Hyperbolic sine
sinh(0) = 0
cosh(x)
Hyperbolic cosine
cosh(0) = 1
tanh(x)
Hyperbolic tangent
tanh(0) = 0
asinh(x), arcsinh(x)
Inverse hyperbolic sine
asinh(0) = 0
acosh(x), arccosh(x)
Inverse hyperbolic cosine (defined for x ≥ 1)
acosh(1) = 0
atanh(x), arctanh(x)
Inverse hyperbolic tangent (defined for |x| < 1)
atanh(0) = 0
🔸 Exponential and Logarithmic Functions
Function(s)
Description
Example
exp(x)
Euler's number raised to x (e^x)
exp(1) = e ≈ 2.718
exp2(x)
2 raised to the power x (2^x)
exp2(3) = 8
log(x), ln(x)
Natural logarithm (base e)
ln(e) = 1
log10(x)
Logarithm base 10
log10(1000) = 3
log2(x)
Logarithm base 2
log2(8) = 3
logb(b, x)
Logarithm base b
logb(e, e ^ 3) = 3
Function(s)
Description
Example
round(x)
Rounds x to the nearest integer
round(2.5) = 2
floor(x)
Rounds x down to the nearest integer (toward −∞)
floor(2.9) = 2
ceil(x)
Rounds x up to the nearest integer (toward +∞)
ceil(2.1) = 3
trunc(x)
Truncates the decimal part of x (rounds toward 0)
trunc(-2.9) = -2
🔸 Power and Root Functions
Function(s)
Description
Example
sqrt(x)
Square root
sqrt(9) = 3
cbrt(x)
Cube root
cbrt(8) = 2
pow(x, y)
x raised to the power of y
pow(2, 3) = 8
hypot(x, y)
Euclidean distance √(x² + y²) (length of hypotenuse)
hypot(3, 4) = 5
Function(s)
Description
Example
abs(x)
Absolute value of x
abs(-3) = 3
mod(x, y)
Floating-point remainder of x / y
mod(8.6, 3) = 2.6
remainder(x, y)
Remainder closest to zero (ties round to even)
remainder(8.6, 3) = -0.4
fma(x, y, z)
Same as x * y + z but with less rounding error
fma(5, 6, -1) = 29
max(a, b, ..., n)
Maximum value among all arguments
max(4, 1, 6) = 6
min(a, b, ..., n)
Minimum value among all arguments
min(4, 1, 6) = 1
factorial(x)
Computes x!
factorial(5) = 120
gamma(x)
Euler’s gamma function: Γ(x) (generalization of factorial)
gamma(6) = 120
lgamma(x)
Natural logarithm of the absolute value of the gamma function Γ(x)
lgamma(5) = 3.178
erf(x)
Error function (used in probability and statistics)
erf(0) = 0
erfc(x)
Complementary error function: 1 - erf(x)
erfc(0) = 1
j0
Bessel function of the first kind, order 0 → J0(x)
j0(0) = 1
j1
Bessel function of the first kind, order 1 → J1(x)
j1(0) = 0
jn
Bessel function of the first kind, order n → Jn(x)
jn(2, 5) = 0.046
y0
Bessel function of the second kind, order 0 → Y0(x)
y0(.5) = -0.444
y1
Bessel function of the second kind, order 1 → Y1(x)
y1(3) = 0.324
yn
Bessel function of the second kind, order n → Yn(x)
yn(5, 1) = -260.405
Your input may trigger descriptive errors like:
Expected ')', got 'end of input'
Division by zero (5 / 0)
Undefined variable 'cot'
Expected a number or parenthesized expression, got ','
Function 'pow' expects at least 2 arguments, got 1
# clone the repo
git clone --recursive https://github.com/brkahmed/CalcX.git && cd CalcX
mkdir build && cd build
# build in debug mode
cmake -DCMAKE_BUILD_TYPE=Debug ..
# build in release mode
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .
# run tests
ctest --output-on-failure