toolgood/ToolGood.Algorithm: ToolGood.Algorithm is a powerful, lightweight, Excel formula compatible algorithm library aimed at improving developers’ productivity in different business scenes. ToolGood.Algorithm是一个功能强大、轻量级、兼容Excel公式

// 编译并执行公式 var fn = engine.Parse("1+2"); var o = engine.Evaluate(fn); double a = o.DoubleValue; // Return: 3 返回:3

var b = engine.TryEvaluate("1=1 && 1<2 || 7-8>1", 0);// Support(支持) && || var c = engine.TryEvaluate("2+3", 0); var q = engine.TryEvaluate("-7 < -2 ?1 : 2", 0); var e = engine.TryEvaluate("count(array(1, 2, 3, 4))", 0);//{} represents array, return: 4 {}代表数组, 返回:4 var s = engine.TryEvaluate("'aa'&'bb'", ""); //String connection, return: aabb 字符串连接, 返回:aabb var r = engine.TryEvaluate("(1=1)*9+2", 0); //Return: 11 返回:11 var d = engine.TryEvaluate("'2016-1-1'+1", DateTime.MinValue); //Return date: 2016-1-2 返回日期:2016-1-2 var j = engine.TryEvaluate("json('{\"Name\":\"William Shakespeare\", \"Age\":51, \"Birthday\":\"04/26/1564 00:00:00\"}').Age", null);//Return 51 返回51 var k = engine.TryEvaluate("json('{\"Name\":\"William Shakespeare \", \"Age\":51, \"Birthday\":\"04/26/1564 00:00:00\"}')['Name'].Trim()", null);//Return "William Shakespeare" 返回"William Shakespeare" (不带空格) var l = engine.TryEvaluate("json('{\"Name1\":\"William Shakespeare \", \"Age\":51, \"Birthday\":\"04/26/1564 00:00:00\"}')['Name'& 1].Trim().substring(2, 3)", null);//Return "ill" 返回"ill" var n = engine.TryEvaluate("{Name:\"William Shakespeare\", Age:51, Birthday:\"04/26/1564 00:00:00\"}.Age", null);//Return 51 返回51 var m = engine.TryEvaluate("[1,2,3,4,5,6].has(13)", true);//Return false 返回false

支持常量true, false。

数值转bool，非零为真, 零为假。字符串转bool, 0、FALSE、NO、无、没有、不是、否为假，1、TRUE、YES、是、有为真。不区分大小写。

bool转数值，假为0，真为1。bool转字符串，假为FALSE，真为TRUE。

索引默认为Excel索引，如果想用c#索引，请设置UseExcelIndex为false。

中文符号自动转成英文符号：括号, 逗号, 引号, 双引号,加，减，乘,除,等号。

注：字符串拼接使用&。

注：find为Excel公式，find(要查找的字符串, 被查找的字符串[, 开始位置])

注：6.0版本开始,[X,X]数组代码替换{X,X}。

注：6.2版本开始，禁止时间转数字，数字转时间，时间加减乘除数字，相关操作使用函数代替。

自定义参数

protected override Operand GetParameter(string parameter) { if (parameter == "半径") { return Operand.Create(_radius); } if (parameter == "直径") { return Operand.Create(_radius * 2); } if (parameter == "高") { return Operand.Create(_height); } return base.GetParameter(parameter); } } //Call method 调用方法 Cylinder c = new Cylinder(3, 10); c.TryEvaluate("半径半径pi()", 0.0); //Round bottom area 圆底面积 c.TryEvaluate("直径*pi()", 0.0); //The length of the circle 圆的周长 c.TryEvaluate("半径半径pi()*高", 0.0); //Volume of circle 圆的体积 c.TryEvaluate("'圆-'&半径&'-'&高", ""); // Return: 圆-3-10

参数定义参数名，
注：不支持5.9版本以下 [参数名]，【参数名】，#参数名#，@参数名。

注：AlgorithmEngineEx 可以使用AddParameter、AddParameterFromJson添加参数。

注：可以重写GetParameter、ExecuteDiyFunction方法，来自定义参数和自定义方法。

注：使用 AlgorithmEngineHelper.GetDiyNames 获取参数名、自定义方法名。

辅助方法

## 支持单位
可设置标准单位：长度DistanceUnit(默认：m)、面积AreaUnit(默认：m2)、体积VolumeUnit(默认：m3)、重量MassUnit(默认：kg)。

注：公式计算时，先将带单位的数量转成标准单位，再进行数字计算。

// 单位转化 var num = AlgorithmEngineHelper.UnitConversion(1M,"米","千米");

// 不抛错例子 bool error = engine.TryEvaluate("1m=1m2", false); // return true

## 计算逻辑引擎

CalculationLogicEngine 用于构建可追溯的多步骤计算流程：通过初始化值、检查条件、公式赋值、设置值等步骤逐步计算，并自动输出完整的计算过程信息，便于审计、调试与流程跟踪。

var logic = new CalculationLogicEngine(new FunctionCache(), useCalculationLogicInfo: true);

logic.SetSceneName("折扣计算"); // 设置场景名称 logic.InitValue("price", 100M); // 初始化值 logic.InitValue("count", 3M);

if (logic.CheckCondition("count>=3", 1)) { // 检查条件（支持层级） logic.SetFormula("total", "pricecount0.8", 0, "满3件打8折"); // 用公式赋值 } else { logic.SetFormula("total", "price*count", 0); }

注：

Excel公式

注：函数名不分大小写, 带方括号的参数可省略, 示例的返回值, 为近似值。

逻辑函数

数学与三角函数

文本函数

日期与时间函数

##### 扩展函数