asccalc - A Simple Console Calculator
Pretty much a fully featured console calculator. One of the few that makes it easy to use logic operations and different bases.
+ Addition
- Subtraction
* Multiplication
/ Divison
% Modulo (Remainder)
** raise to the power of...
^^ same as **
& Bitwise And
and same as &
| Bitwise Or
or same as |
^ Bitwise Exclusive-Or
xor same as ^
<< Logical shift left (arithmetic shift for negative numbers)
>> Logical shift right (arithmetic shift for negative numbers)
Numbers can be expressed in many different ways. Here are some examples:
0xFF
0b010101
5
0d5
0755
5.71
5.71E-5
5.71p
Digits may include _ separators for readability as long as each _ appears between digits, for example 1_000_000, 0xDEAD_BEEF, 1_234.56_78, and 5.7_1E-5.
As the last example shows, several SI suffixes are available, with their usual meaning:
a,f,p,n,u,m,k,M,G,T,P,E
>= Greater or equal
<= Less or equal
!= Not equal
== Equal
> Greater than
< Less than
- Unary minus
~ 1's complement
! Factorial
[hi:lo] Verilog-style part select (select bits from MSB=hi to LSB=lo)
[hi-:cnt] Verilog-style part select (select cnt bits downwards from MSB=hi)
A statement (i.e. an expression using operators) is evaluated at the end of the line (e.g. when ENTER is pressed) unless the last character of the line was a backslash (''), in which case the newline is ignored. Statements can have a trailing semicolon (';') when stand-alone, and must have a trailing semicolon (';') when they are part of a listing (more on that later). Example:
1 + 5 * 7
or
1 + 5 * 7;
or
1 + 5 * \
7
or
1 + 5 * \
7;
The following constants are predefined:
pi Pi (3.14159...)
e Euler's number (2.71828...)
G Catalan's constant (0.91597...)
ans Result of the last evaluated expression
User-defined variables can be created with the following syntax,
VARIABLE_NAME = STATEMENT
For example,
x = 5 * pi;
where the trailing semicolon (';') is optional.
if/elsif/else and while flow control is available.
The conditional construct if is as follows, where the 'else LISTING' part is optional,
if CONDITION then LISTING else LISTING fi
A conditional construct can also contain any number of elsifs:
if CONDITION then LISTING elsif CONDITION then LISTING else LISTING fi
if CONDITION then LISTING elsif CONDITION then LISTING elsif CONDITION then LISTING else LISTING fi
For incomplete if statements (i.e. lacking else) a default value of 0 is returned if no condition matches. Otherwise the value of the last expression to be evaluated in a LISTING is returned. The condition can be any statement (see above) that is considered true if it evaluates to a non-zero value. The LISTING is a series of statements delimited by a trailing semicolon (';') or other flow control constructs. After the 'if', a newline can be introduced at any time until the closing 'fi'. Examples:
if (x > 5) then
x/5;
else
x*5;
fi
if (x > 5)
then
x/5;
fi
The while construct similarly is,
while CONDITION do LISTING done
A default value of 0 is returned if the condition is false. Otherwise the value of the last evaluated expression is returned. The condition can be any statement (see above) that is considered true if it evaluates to a non-zero value. The LISTING is a series of statements delimited by a trailing semicolon (';') or other flow control constructs. After the 'while', a newline can be introduced at any time until the closing 'done'. Examples:
x = 1;
while (x < 5) do
x = x * 2;
done
User-defined functions can be defined using the function keyword. The syntax is as follows:
function NAME(NAMELIST) = LISTING endfunction
The LISTING is a series of statements delimited by a trailing semicolon (';') or flow control constructs. The NAMELIST is a list of comma-separated argument variables to the function. After the 'function' token, a newline can be introduced at any time until the closing 'endfunction'. All user-defined variables assigned in the body of the function are local to the function. The scope inside a function is the global scope and the direct arguments to the function. It does not include any other scope, e.g. the scope of the calling function for a nested function.
Example:
function sum(a,b) =
a + b;
endfunction
function foobar(a,b,c) =
x = e * a;
x = sum(x, a);
root(x, c);
endfunction
Comments can either start with // or #
if, then, else, fi, while, do, done, function, endfunction, require, ls, lsfn, quit, exit, help, mode, and, or, xor
ls Lists all variables
lsfn Lists all functions (builtin and user-defined)
help Lists available commands
help <name> Show help for a builtin or user-defined function
m <mode> Same as mode <mode>
mode <mode> Switches to output mode <MODE>, where mode is one of
the following:
b - for binary output
d - for decimal output
s - for decimal scientific output
h or x - for hexadecimal output
o - for octal output
require "<filename>" Load and evaluate a file
quit Exits the program
exit Exits the program
Check with the 'lsfn' commands for the most up-to-date list.
Use help <name> for signatures, argument descriptions, return notes, and selected examples.
sqrt(a) Square Root of a
cbrt(a) Cubic Root of a
root(a,n) n-th root of a
abs(a) Absolute value of a
sgn(a) Sign of a: returns -1, 0, or 1
ln(a) Natural Logarithm of a
log2(a) Logarithm base 2 of a
log10(a) Logarithm base 10 of a
exp(a) exponential of a
sec(a)
csc(a)
cot(a)
cos(a)
sin(a)
tan(a)
acos(a)
asin(a)
atan(a)
atan2(y,x)
cosh(a)
sinh(a)
tanh(a)
sech(a)
csch(a)
coth(a)
acosh(a)
asinh(a)
atanh(a)
erf(a) Error function of a
erfc(a) Complementary error function of a
hypot(x,y) Hypotenuse of x and y, i.e. sqrt(x^2 + y^2)
round(a) Round a to nearest integer
ceil(a) Round a upwards to nearest integer
floor(a) Round a downwards to nearest integer
trunc(a) Truncate a to an integer
int(a) Same as trunc(a)
deg2rad(a) Convert degrees to radians
rad2deg(a) Convert radians to degrees
nextprime(a) Gives the next highest prime number after a
gcd(a,b) Greatest common divisor of a and b
lcm(a,b) Least common multiple of a and b
remfac(a,b) Remove factor b from a
bin(a,b) Binomial coefficient (a | b)
comb(a,b) Same as bin(a,b)
fib(n) n-th fibonacci number
inv(a,N) Find the inverse of a (modulo N)
invert(a,N) Same as inv(a,N)
hamdist(a,b) Gives the hamming distance between integers a and b
countones(a) Returns the number of 1-bits in integer a
popcount(a) Same as countones(a)
popcnt(a) Same as countones(a)
bits(a) Number of bits needed to represent integer a (floor(log2(a))+1)
msb(a) Index of the most significant set bit (floor(log2(a))), a > 0
ctz(a) Index of the least significant set bit (count trailing zeros), a != 0
min(a,b,...) Minimum of a,b,...
max(a,b,...) Maximum of a,b,...
avg(a,b,...) Average of a,b,...
tabulate(f,a,b,...) Print the result of applying function f to a, b, ... as a table
flex (build only)
bison (build only)
libmpfr
libgmp
To build on Ubuntu and Debian:
apt-get install flex bison libmpfr-dev libgmp-dev make gcc
To just use a binary package:
apt-get install libgmp10 libmpfr6
On startup, asccalc loads the following files if they exist:
~/.asccalc.rc— evaluated silently before the first prompt~/.asccalc.rc.d/*— each file in this directory is evaluated in alphabetical order
Command history is saved to and loaded from ~/.asccalc.history.
Just type
make