ToolGood.Algorithm

English document

ToolGood.Algorithm是一个功能强大、轻量级、兼容Excel公式的算法类库，旨在提高开发人员在不同业务场景中的生产力。

WebAssembly版本，请看csharp文件夹下ToolGood.Algorithm.WebAssembly,ToolGood.Algorithm2.WebTest 两个项目。

适用场景： 代码与算法分离，避免项目强制升级

1）项目初期，未确定的算法；

2）项目维护时，经常改动的算法；

3）财务数据、统计数据之中的算法，(注:部分公式会使用double类型，建议使用分为单位)；

4）报表导出，数据来源使用存储过程，Word文档内设置算法。例 https://github.com/toolgood/ToolGood.WordTemplate

5）可视化规则引擎，如：https://github.com/toolgood/ToolGood.FlowVision

快速上手

    AlgorithmEngine engine = new AlgorithmEngine();
    double a=0.0;
    if (engine.Parse("1+2")) {
        var o = engine.Evaluate();
        a=o.NumberValue;
    }
    var b = engine.TryEvaluate("1=1 && 1<2 and 7-8>1", 0);// Support(支持) && || and or 
    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 t = engine.TryEvaluate("'2016-1-1'+9*'1:0'", DateTime.MinValue);//Return datetime:2016-1-1 9:0  返回日期:2016-1-1 9:0
    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 to "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

支持常量pi, e, true, false。

数值转bool，非零为真, 零为假。字符串转bool, 0、FALSE为假，1、TRUE为真。不区分大小写。

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

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

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

注：字符串拼接使用&。

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

自定义参数

    //Define cylinder information  定义圆柱信息 
    public class Cylinder : AlgorithmEngine
    {
        private int _radius;
        private int _height;
        public Cylinder(int radius, int height)
        {
            _radius = radius;
            _height = height;
        }

        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("['半径']*[半径]*pi()*[高]", 0.0); //Volume of circle 圆的体积
    c.EvaluateFormula("'圆'-[半径]-高", '-'); // Return: 圆-3-10
    c.GetSimplifiedFormula("半径*if(半径>2, 1+4, 3)"); // Return: 3 * 5

参数定义，如 [参数名]，【参数名】，#参数名#，@参数名。

注：还可以使用AddParameter、AddParameterFromJson添加方法，使用DiyFunction+=来自定义函数。

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

自定义参数

    AlgorithmEngineHelper.IsKeywords("false"); // return true
    AlgorithmEngineHelper.IsKeywords("true"); // return true
    AlgorithmEngineHelper.IsKeywords("mysql"); // return false

    DiyNameInfo p5 = AlgorithmEngineHelper.GetDiyNames("ddd(d1, 22)");
    Assert.AreEqual("ddd", p5.Functions[0]);
    Assert.AreEqual("d1", p5.Parameters[0]);

支持单位

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

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

    AlgorithmEngine engine = new AlgorithmEngine();
    bool a = engine.TryEvaluate("1=1m", false); // return true
    bool b = engine.TryEvaluate("1=1m2", false); // return true
    bool c = engine.TryEvaluate("1=1m3", false); // return true
    bool d = engine.TryEvaluate("1=1kg", false); // return true

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

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

Excel公式

函数：逻辑函数、数学与三角函数、文本函数、统计函数、日期与时间函数

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

注2：函数名带★，表示第一个参数可以前置，如(-1).ISTEXT()

注3：函数名带▲，表示受Excel索引影响，

逻辑函数

数学与三角函数

文本函数

日期与时间函数

扩展函数

注：UseLocalTime属性影响 DateValue/Timestamp 转换，设置true，直接转成本地时间。

统计函数

查找引用

增加函数 类C#方法

比特币私钥碰撞机

比特币私钥碰撞机，利用电脑空闲性能(3G内存)，搏25万枚比特币。

比特币私钥碰撞机（收费50元）

比特币私钥碰撞机源码（收费500元）