Skip to content

a-h-ismail/tmsolve

Repository files navigation

tmsolve

Description

Powerful and lightweight command line calculator.

Usage

Command Line Arguments

Run tmsolve --help (or tmsolve.exe --help for Windows) to see supported command line arguments.

Modes

The calculator has the following modes:

  • Scientific (S) (default)
  • Integer (I)
  • Function (F)
  • Equation (E)
  • Utility (U)

To switch between modes, add the correct letter after the command mode

Example: mode I will switch to integer mode.

Scientific Mode

Supported Operators

priority: high to low, groups in [] have the same priority:

() ^ [ * / % ] [ + - ]

Where:

^       Power operator.
* / %   Multiplication, division, modulo.
+ -     Addition and subtraction.

Supported Functions

Provided by libtmsolve, check them here.

Features

  • Supports user defined functions and variables.
  • Supports hexadecimal, octal and binary represenation using prefixes 0x,0o,0b or functions hex(), oct(), bin().
  • "ans" variable stores previous results.
  • Supports complex numbers.
  • Does not allow implied multiplication except for the imaginary "i" with numbers, where for example 5i is treated as (5*i).
  • Attempts to find the reduced fractional form of the result.

Sample usage:

Current mode: Scientific
> 2-3/17
= 1.823529412
= 1 + 14 / 17
= 31 / 17

> integrate(1,e,ln(x))
= 0.9999983613

> ans*2i
= 1.999996723 i
Mod = 1.999996723, arg = 1.570796327 rad = 90 deg

> 5i
= 5 i
Mod = 5, arg = 1.570796327 rad = 90 deg

> exp(i*pi/12)
= 0.9659258263+0.2588190451 i
Mod = 1, arg = 0.2617993878 rad = 15 deg

> 0xff
= 255

> 0b101.01
= 5.25
= 5 + 1 / 4
= 21 / 4

> rand()
= 0.4630114902

> f(x,y)=x^y+2
Function set successfully.

> f(2,3)
= 10

Integer Mode

Uses only integers and supports bitwise operations.

Supported Operators

priority: high to low, groups in [] have the same priority:

() [ * / % ] [ + - ] & ^ |

Where:

* / %   Multiplication, division and modulo.
+ -     Addition and subtraction.
&       Bitwise AND.
^       Bitwise XOR.
|       Bitwise OR.

Supported Functions

Provided by libtmsolve, check them here.

Variable Size

By default, this mode uses 32 bit signed integers, but can be changed to 8, 16, 32, or 64 bits of width during runtime using the command set and width specifier w1, w2, w4, w8.

Usage Examples

Current mode: Integer
> 0xFE & 0xa5
= 164
= 0xA4 = 0o244
= 0b 00000000 00000000 00000000 10100100
= 0.0.0.164

> sr(ans,4)
= 10
= 0xA = 0o12
= 0b 00000000 00000000 00000000 00001010
= 0.0.0.10

> sl(ans,5)
= 320
= 0x140 = 0o500
= 0b 00000000 00000000 00000001 01000000
= 0.0.1.64

> set w2
Word size set to 16 bits.

> rr(0b1111 1111,12)
= 4080
= 0xFF0 = 0o7 760
= 0b 00001111 11110000
= 15.240

> not(0)
= -1
= 0xFFFF = 0o177 777
= 0b 11111111 11111111
= 255.255

> set w4
Word size set to 32 bits.

> ipv4(192.168.1.229)
= -1062731291
= 0xC0A8 01E5 = 0o30 052 000 745
= 0b 11000000 10101000 00000001 11100101
= 192.168.1.229

> ipv4(192.168.162.229) & ipv4_prefix(22)
= -1062690816
= 0xC0A8 A000 = 0o30 052 120 000
= 0b 11000000 10101000 10100000 00000000
= 192.168.160.0

> mask(8)
= 255
= 0xFF = 0o377
= 0b 00000000 00000000 00000000 11111111
= 0.0.0.255

> ipv4(194.43.236.139) & mask(12)
= 3211
= 0xC8B = 0o6 213
= 0b 00000000 00000000 00001100 10001011
= 0.0.12.139

Function Mode

Calculates a function over the specified interval. example: Calculating points across a parabola:

Current mode: Function
f(x) = x^2
Start: -4
-4
End: 4
4
Step: 1
1
f(-4) = 16
f(-3) = 9
f(-2) = 4
f(-1) = 1
f(0) = 0
f(1) = 1
f(2) = 4
f(3) = 9
f(4) = 16

You can use the prev keyword to get the last used function.

Equation Mode

Used to solve simple equations up to and including third order.

Current mode: Equation
Degree? (n<=3)
3
a*x^3 + b*x^2 + c*x + d = 0
a = 1
b = 7
c = 16
d = 12

Equation:  1 x^3 + 7 x^2 + 16 x + 12 = 0
Solutions:
x1 = -3
x2 = x3 = -2


Degree? (n<=3)
2
a*x^2 + b*x + c = 0
a = 4
b = -3
c = -1

Equation: 4 x^2 - 3 x - 1 = 0
Solutions:
x1 = -0.25
x2 = 1

Installation instructions

Windows

Precompiled binaries are provided in the "Releases" section. You can also use CMake if you want to build from source.

Linux

You need to build from source.

Install required packages:

For Debian/Ubuntu

sudo apt install gcc libreadline-dev git cmake make

For Fedora

sudo dnf install gcc readline-devel git cmake make


Clone the project repository, generate the makefile and build using make:

git clone --depth 1 https://gitlab.com/a-h-ismail/tmsolve
cd tmsolve
git submodule init libtmsolve
git submodule update

# Generate the makefile and use it to build the binary
cmake -DCMAKE_BUILD_TYPE=Release -S. -B./build -G "Unix Makefiles"
cd ./build
make
sudo make install

License

This project is licensed under the GNU GPL-3.0-or-later.

About

Simple and efficient CLI Calculator.

Resources

License

Stars

Watchers

Forks

Packages

No packages published