README.md

MathStringExpression

XIB执行命令行！

Let XIB execute the command line!

Introduction 简介

• 为需要开发iOS计算器的开发者提供的一个便捷
• 计算字符串数学表达式
• 包括自定义运算符，计算方式。
• 该项目默认使用JavaScript.Math库函数的命名方式
• 可在项目表达式和JavaScript表达式之间转换
• 随手一赞，好运百万
• A convenience for developers who need to develop calculators.
• Mathematical expression for calculating string
• Custom operators and calculation methods
• The project defaults to using JavaScript Math function
• JavaScript expression can be transferred to the JavaScript engine to calculate the expression
• Once start me,Day day fuck Lynn

Ussage 如何使用

//1.将整个文件夹拖入项目
#import "MathStringExpression.h"

New!【新增】不定参数的支持

MSFunctionOperator* sum = [MSFunctionOperator operatorWithKeyValue:@{@"name":@"sum",@"level":@(1),@"argsCount":@(-1)}];
[sum computeWithBlock:^id (NSArray *args) {
    double result = 0.0;
    for (NSNumber* num in args) {
        result += num.doubleValue;
    }
    return [NSDecimalNumber numberWithDouble:result];
}];

Changed【修改】

//注意：系统函数max和min修改为不定参数形式，但转为js依然为2个参数
//计算结果返回值类型由NSNumber修改为NSString

Start 开始使用--计算表达式

NSString* computeResult = [MSParser parserComputeExpression:@"2(-1*3)+random()" error:nil];
/*
 *  重要的：
 *  1.项目默认使用JavaScript.Math库函数命名方式
 *  2.需要控制小数点精度的情况使用[parserComputeNumberExpression:error:]
*/

运算符类图

默认运算符列表

常量列表

自定义运算符

//自定义次方算术运算符^，可知优先级与*号相同
MSValueOperator* _pow = [MSValueOperator operatorWithKeyValue:@{@"name":@"^",@"level":@(3)}];
//定义如何计算
[_pow computeWithBlock:^id (NSArray *args) {

    //1.返回值的类型可以是MSValue的所有派生类型和NSNumber的所有派生类型
    //2.计算结果的精度和返回值的精度有关，越精确越好
    return [NSDecimalNumber numberWithDouble:pow([args[0] doubleValue], [args[1] doubleValue])];//推荐
    //return @(pow([args[0] doubleValue], [args[1] doubleValue]));//这种方式0.3-0.2打印出来是0.99999...，而使用NSDecimalNumber则不会有问题；但是NSDecimalNumber可能会出现小数点后面十几个0的情况，就需要控制小数点位数了。比如π参加运算的时候会造成小数点位数特别多。
    
}];

导入自定义运算符

MSElementTable* tab = [MSElementTable defaultTable];
[tab setElement:_pow];

定义运算符或常量的表现名

MSConstant* pi = [[tab elementsFromString:@"PI"] firstObject];//查询元素
pi.showName = @"π";//设置表现名
[tab setElement:pi];//导入表中
//可解析带有π的表达式

重名不同优先级运算符冲突的判定

//例如项目中已实现了的，解决负号和减号判定的样例
[[MSElementTable defaultTable] handleConflictOperator:@"-"
                  usingBlock:^MSOperator *(NSArray<MSOperator*>* conflictOps,
                                          NSUInteger idx ,
                                          NSArray<MSElement*>* beforeElements,
                                          NSArray<NSString*>* elementStrings) {
  //conflictOps按运算符优先级排列
  if(idx == 0){
       //前一个元素不存在或者是左括号或优先级小于负号的则为负号
       return conflictOps.firstObject;
   }else if ([[beforeElements lastObject] isKindOfClass:[MSPairOperator class]]){
       if([((MSPairOperator*)[beforeElements lastObject]).name isEqualToString:@"("]){
              return conflictOps.firstObject;
       }
   }else if([[beforeElements lastObject] isKindOfClass:[MSValueOperator class]]){
       if(((MSValueOperator*)[beforeElements lastObject]).level >= 2){
          return conflictOps.firstObject;
       }
  }
      return conflictOps.lastObject;
}];

表达式转JavaScript表达式

NSString* jsExpression = [MSParser parserJSExpressionFromExpression:@"sin(PI)" error:nil];
//结果为(Math.sin(PI))，可交由JavaScriptCore运算

表达式转JavaScript表达式中的自定义运算符

//如果JS表达式与当前命名不同则需定义jsTransferOperator对象，无此需求则忽略该步骤。
MSValueOperator* _sqr = [MSValueOperator operatorWithKeyValue:@{@"name":@"√", @"level":@(3)}];
[_sqr computeWithBlock:^id (NSArray *args) {
        return [NSDecimalNumber numberWithDouble:pow([args[1] doubleValue], 1.0/[args[0] doubleValue])];
}];
[tab setElement:_sqr];
//由于原运算符为算术运算符而js中是函数运算符，所以这里定义一个函数运算符。(不定义该对象默认使用原对象)
MSOperator* sqr_js = [MSOperator operatorWithKeyValue:@{@"name":@"Math.pow",@"level":@(1)}];
_sqr.jsTransferOperator = sqr_js;

转为JavaScript中不存在的表达形式

//承接上例
//这里自定义如何输出字符串表达式，用于转换到JavaScript表达式
[sqr_js customToExpressionUsingBlock:^NSString *(NSString *name, NSArray<NSString*> *args) {
    //转换为pow(a,1/b)形式
    return [NSString stringWithFormat:@"%@(%@,1/%@)",name,args[0],args[1]];
}];

使用JavaScript定义函数

MSFunctionOperator* addJS=[MSFunctionOperator operatorWithJSFunction:@"function And(a,b){return a+b;}" 
                                                                 error:nil];
[tab setElement:addJS];

使用JavaScript定义常量

MSConstant* ageJS = [MSConstant constantWithJSValue:@" var age = 18.00; " error:nil];
[tab setElement:ageJS];

Mail address quxingyi@outlook.com

• 穷啊啊啊