csmic 1.1.3
CS-MIC is a .NET library written in C# designed to give developers easy access to expression parsing. For many developers, there is no need to involve complicated settings and formats. With few exposed methods and objects, CS-MIC makes basic expression solving as simple as possible with as little logic required from developers as possible. In fact, one can pull a value with only one line of code.
See the version list below for details.
cs-mic
CS-MIC is a .NET library written in C# designed to give developers easy access to expression parsing. For many developers, there is no need to involve complicated settings and formats. With few exposed methods and objects, CS-MIC makes basic expression solving as simple as possible with as little logic required from developers as possible. In fact, one can pull a value with only one line of code.
Usage
CS-MIC follows a few basic rules when interpreting user input, but should prove to be fairly straightforward for most developers. While CS-MIC tries to ensure that the order of operations as far as it knows them (parentheses – powers, multiplication, division – addition, subtraction), there may be instances where formatting fails. If this should be noticed, please report it.
Expression Parsing
Operands
+
- Addition
–
- Subtraction
*
- Multiplication
/
- Division
^
- Raise to a power
%
- Modulus
Tokens
::
- Assign a numeric value to a variable.
:=
- Assign an equation to a variable.
->
- Assigns a comma delimited array of numbers to an array variable.
Comparison
==
- Returns ‘True’ if two values are equal to each other.
>
- Returns ‘True’ if a value is greater than another value.
<
- Returns ‘True’ if a value is less than another value.
>=
- Returns ‘True’ if a value is greater than or equal to another value.
<=
- Returns ‘True’ if a value is greater than or equal to another value.
Base Conversion
- Decimal
- All numbers are interpreted as decimal by default.
- Binary
- Binary numbers are succeeded by a B, non case sensative.
- Hexadecimal
- Hexadecimal numbers are preceded by 0x, non case sensative.
Example Input and Output
Input|Output
:-----:|:-----:
5 + 5
| 10
5 * 2
| 10
1 + 2 * 3
| 7
(1 + 2) * 3
| 9
5 / 2
| 2.5
5 / 0
| Attempted to divide by zero.
2 ^ 32
| 4294967296
x :: 4
| 4
x :: 6 + 4
| 10
y := 2^x
| (2^x)
Scripting
Rules
- Any valid expression can be computed.
- All computation counts towards the script’s history. This means that once a variable is set inside a script, the variable will remain set until execution of the script is complete.
- Only one command can be executed per line. No token is required to end the command.
- Every code block must be opened and closed with a bracket ( { } ). The only exception is the main code block.
Loops
while
- Executes a code block as long as a given condition evaluates to true.
while(bool expression)
{
CODE BLOCK
}
for
- After executing an initial condition, a code block is executed while a condition is met. A final statement is executed at the end of each iteration.
for(* expression, bool condition, * expression)
{
CODE BLOCK
}
Conditionals
if
- Executes a code block if a given condition evaluates to true. An optional else block can follow the if block for execution if the statement evaluates as false.
if(bool expression)
{
CODE BLOCK
}
else
{
CODE BLOCK
}
Functions
echo
- Displays the output from the proceding expression.
echo: expression
say
- Displays a string.
say: “string”
display
- Combines strings and expressions to a single line in the output stack.
display: “string”, 12 * 2, “string”, sin(12)
function
- Creates a new function with a given name, and any number of expected arguments.
function(newFunction, anyArgumentName)
{
sin(anyArgumentName) + cos(anyArgumentName)
}
Comments
- Block Tokens
- Starting token: /*
- Ending token: */
*Any line falling between block comment tokens will be ignored by the macro builder at execution time.
- Line Tokens
- //
- Any line starting with the line token will be ignored by the macro builder at execution time.
- //
Example Script
say: “Fibonacci Sequence”
temp :: 1
y :: 1
echo: y
for(x :: 1, x < 11, x :: temp + y)
{
echo: x
temp :: y
y :: x
}
x :: 1
say: “While Loop”
while(x < 10)
{
if(x == 5)
{
display: “The condition ‘x == 5’ has been met. x = “, x, “.”
}
else
{
echo: sin(x)
}
x :: x + 1
}
Example Script Output
Fibonacci Sequence
1
1
2
3
5
8
13
21
34
55
89
While Loop
0.841470984807897
0.909297426825682
0.141120008059867
-0.756802495307928
The condition ‘x == 5’ has been met. x = 5.
-0.279415498198926
0.656986598718789
0.989358246623382
0.412118485241757
Built In Functions
The following is a list of the internally recognized functions in CS-MIC:
sin(double expression)
Returns the sine value of a given expression.
cos(double expression)
Returns the cosine value of a given expression.
tan(double expression)
Returns the tangent value of a given expression.
round(double expression)
Rounds an expression to the nearest whole number.
sqrt(double expression)
Returns the square root of an expression.
abs(double expression)
Returns the absolute value of a given expression.
exp(double expression)
Returns the constant e raised to a given power.
log(double expression1, double expression2)
Returns the log of expression1 to the base of expression2
precision(double expression1, int expression2)
Returns the value of expression1 to a given precision. For example, precision(12.3456789, 4) will return 12.3456.
cs-mic
CS-MIC is a .NET library written in C# designed to give developers easy access to expression parsing. For many developers, there is no need to involve complicated settings and formats. With few exposed methods and objects, CS-MIC makes basic expression solving as simple as possible with as little logic required from developers as possible. In fact, one can pull a value with only one line of code.
Usage
CS-MIC follows a few basic rules when interpreting user input, but should prove to be fairly straightforward for most developers. While CS-MIC tries to ensure that the order of operations as far as it knows them (parentheses – powers, multiplication, division – addition, subtraction), there may be instances where formatting fails. If this should be noticed, please report it.
Expression Parsing
Operands
+
- Addition
–
- Subtraction
*
- Multiplication
/
- Division
^
- Raise to a power
%
- Modulus
Tokens
::
- Assign a numeric value to a variable.
:=
- Assign an equation to a variable.
->
- Assigns a comma delimited array of numbers to an array variable.
Comparison
==
- Returns ‘True’ if two values are equal to each other.
>
- Returns ‘True’ if a value is greater than another value.
<
- Returns ‘True’ if a value is less than another value.
>=
- Returns ‘True’ if a value is greater than or equal to another value.
<=
- Returns ‘True’ if a value is greater than or equal to another value.
Base Conversion
- Decimal
- All numbers are interpreted as decimal by default.
- Binary
- Binary numbers are succeeded by a B, non case sensative.
- Hexadecimal
- Hexadecimal numbers are preceded by 0x, non case sensative.
Example Input and Output
Input|Output
:-----:|:-----:
5 + 5
| 10
5 * 2
| 10
1 + 2 * 3
| 7
(1 + 2) * 3
| 9
5 / 2
| 2.5
5 / 0
| Attempted to divide by zero.
2 ^ 32
| 4294967296
x :: 4
| 4
x :: 6 + 4
| 10
y := 2^x
| (2^x)
Scripting
Rules
- Any valid expression can be computed.
- All computation counts towards the script’s history. This means that once a variable is set inside a script, the variable will remain set until execution of the script is complete.
- Only one command can be executed per line. No token is required to end the command.
- Every code block must be opened and closed with a bracket ( { } ). The only exception is the main code block.
Loops
while
- Executes a code block as long as a given condition evaluates to true.
while(bool expression)
{
CODE BLOCK
}
for
- After executing an initial condition, a code block is executed while a condition is met. A final statement is executed at the end of each iteration.
for(* expression, bool condition, * expression)
{
CODE BLOCK
}
Conditionals
if
- Executes a code block if a given condition evaluates to true. An optional else block can follow the if block for execution if the statement evaluates as false.
if(bool expression)
{
CODE BLOCK
}
else
{
CODE BLOCK
}
Functions
echo
- Displays the output from the proceding expression.
echo: expression
say
- Displays a string.
say: “string”
display
- Combines strings and expressions to a single line in the output stack.
display: “string”, 12 * 2, “string”, sin(12)
function
- Creates a new function with a given name, and any number of expected arguments.
function(newFunction, anyArgumentName)
{
sin(anyArgumentName) + cos(anyArgumentName)
}
Comments
- Block Tokens
- Starting token: /*
- Ending token: */
*Any line falling between block comment tokens will be ignored by the macro builder at execution time.
- Line Tokens
- //
- Any line starting with the line token will be ignored by the macro builder at execution time.
- //
Example Script
say: “Fibonacci Sequence”
temp :: 1
y :: 1
echo: y
for(x :: 1, x < 11, x :: temp + y)
{
echo: x
temp :: y
y :: x
}
x :: 1
say: “While Loop”
while(x < 10)
{
if(x == 5)
{
display: “The condition ‘x == 5’ has been met. x = “, x, “.”
}
else
{
echo: sin(x)
}
x :: x + 1
}
Example Script Output
Fibonacci Sequence
1
1
2
3
5
8
13
21
34
55
89
While Loop
0.841470984807897
0.909297426825682
0.141120008059867
-0.756802495307928
The condition ‘x == 5’ has been met. x = 5.
-0.279415498198926
0.656986598718789
0.989358246623382
0.412118485241757
Built In Functions
The following is a list of the internally recognized functions in CS-MIC:
sin(double expression)
Returns the sine value of a given expression.
cos(double expression)
Returns the cosine value of a given expression.
tan(double expression)
Returns the tangent value of a given expression.
round(double expression)
Rounds an expression to the nearest whole number.
sqrt(double expression)
Returns the square root of an expression.
abs(double expression)
Returns the absolute value of a given expression.
exp(double expression)
Returns the constant e raised to a given power.
log(double expression1, double expression2)
Returns the log of expression1 to the base of expression2
precision(double expression1, int expression2)
Returns the value of expression1 to a given precision. For example, precision(12.3456789, 4) will return 12.3456.
Dependencies
This package has no dependencies.
Version History
Version | Downloads | Last updated | |
---|---|---|---|
1.1.4 | 42 | 6/13/2018 | |
1.1.3 (current) | 1,096 | 3/31/2012 | |
1.1.2 | 291 | 3/31/2012 | |
1.1.1 | 294 | 3/31/2012 | |
1.1.0 | 294 | 3/31/2012 |