一. 簡介
一個數(shù)學表達式計算器舵匾，能實現(xiàn)和 UIWebView 的 stringByEvaluatingJavaScriptFromString: 一樣的計算效果窖张，但效率要高很多簸淀，可以在子線程中執(zhí)行青扔；
基本全面覆蓋 NSExpression 的 expressionForFunction:arguments 中的所有function晓猛，使用要比 NSExpression 簡單很多，只需將注意力放大expression表達式的編輯上险领，將任意復(fù)雜度的表達式侨舆，通過eval:方法傳入便可輕松得到計算結(jié)果；
支持復(fù)雜加減乘除四則運算舷暮，與或非邏輯運算态罪，和大于小于等比較運算噩茄；
支持三目運算下面；
表達式中能自動識別處理的函數(shù)，基本全部覆蓋NSExpression绩聘，有的未實現(xiàn)的沥割，因為可以自己有數(shù)學表達式表達，比如 a+b凿菩，這個表達式計算最基本功能机杜，無需通過函數(shù)調(diào)用來實現(xiàn)；
以上所述的計算類型在符合數(shù)學表達式邏輯的前提下衅谷，可以組合在一個表達式中椒拗，函數(shù)支持嵌套調(diào)用；
支持字符串相加（字符串拼接）获黔；
開發(fā)者可以擴展自己的函數(shù)蚀苛，通過構(gòu)建 DFEvaluatorFunction 對象來聲明自定義的函數(shù)，詳細使用方式可以參考 demo玷氏。
二. 使用方式
-
引入頭文件
#import <DFEvalKit/DFEvaluator.h>DFEvaluator.h 文件中只聲明了4個方法：
- -(id)eval:(NSString *)expression // 用于傳入表達式進行計算并返回計算結(jié)果
- -(void)setCustomFunctions:(NSDictionary *)customFunctions // 用于給開發(fā)者注冊自定義方法
- -(void)setDateFormatter:(NSDateFormatter *)dateFormatter // 設(shè)置支持的日期格式堵未，默認只支持 yyyy-MM-dd HH:mm:ss 格式
- -(void)withoutFunctionTransfer:(BOOL)withoutFunction; // 不支持函數(shù)調(diào)用，僅用于計算純數(shù)學表達式盏触，默認為支持函數(shù)調(diào)用
- -(id)eval:(NSString *)expression // 用于傳入表達式進行計算并返回計算結(jié)果
開發(fā)者僅需通過這4個 API 來使用表達式計算全部功能
// DFEvaluator.h
@interface DFEvaluator : NSObject
#pragma mark - API
/**
* 表達式計算
*
* @param expression 需要計算的表達式
*
* @return 計算結(jié)果
*/
- (id)eval:(NSString *)expression;
/**
* 設(shè)置開發(fā)者自定義的函數(shù)集
*
* @param customFunctions 每個函數(shù)用 DFEvaluatorFunction 對象來描述渗蟹，以函數(shù)名為 key
*
*/
- (void)setCustomFunctions:(NSDictionary *)customFunctions;
/**
* 設(shè)置支持的日期格式块饺，默認只支持 yyyy-MM-dd HH:mm:ss 格式
*
* @param dateFormat 日期格式
*/
- (void)setDateFormat:(NSString *)dateFormat;
/**
* 不支持函數(shù)調(diào)用，僅用于計算純數(shù)學表達式雌芽，默認為支持函數(shù)調(diào)用
*/
- (void)withoutFunctionTransfer:(BOOL)withoutFunction;
@end
-
具體使用方式
-
支持的數(shù)學運算操作符和操作數(shù)類型
typedef NS_ENUM(NSInteger, DFEvaluatorNodeType) { /** * 未知 0 */ Unknown, /** * + 加 */ Plus, /** * - 減 */ Subtract, /** * * 乘 */ MultiPly, /** * / 除 */ Divide, /** * ( 左括號 */ LParentheses, /** * ) 右括號 */ RParentheses, /** * % 求模,取余 */ Mod, /** * ^ 冪運算 */ Power, /** * << 左移位 */ LShift, /** * >> 右移位 */ RShift, /** * & 按位與 */ BitwiseAnd, /** * | 按位或 */ BitwiseOr, /** * && 邏輯與 */ And, /** * || 邏輯或 */ Or, /** * ! 邏輯非 */ Not, /** * == 比較等 */ Equal, /** * != 或 <> 比較不等 */ Unequal, /** * > 比較大于 */ GT, /** * < 比較小于 */ LT, /** * >= 比較大于等于 */ GTOrEqual, /** * <= 比較小于等于 */ LTOrEqual, /** * 數(shù)值 */ Numeric, /** * 字符串 */ String, /** * 日期時間 */ Datetime }; -
使用示例
// 簡單四則運算 [DFEvaluator eval:@"22 + 33 * 66 + 3^5"]; // 3^5 3的5次方 // 簡單比較運算 [DFEvaluator eval:@"5 < 6"]; // 邏輯運算 [DFEvaluator eval:@"5 < 3 || 6 > 5)"]; // 位運算 [DFEvaluator eval:@"4 << 5"]; // 字符串相加 [DFEvaluator eval:@"\"Hello\" + \" \" + \"World\" << 5"]; -
包含函數(shù)的運算
-
支持的函數(shù)清單
// 邏輯運算類 ternaryOperation(5<7, \"真\", \"假\") // 三目表達式 日期類處理方法, 日期字符串格式要求為：yyyy-MM-dd或者yyyy-MM-dd HH:mm:ss dateDiff(差值類型, 較早日期, 較晚日期) // 時間差值 getYear(date) // 獲取日期中的年份 getQuarter(date) // 獲取日期中的第幾季度 getLocalQuarter(date) // 獲取日期中的中文第幾季度 getMonth(date) // 獲取日期中的月份 getLocalMonth(date) // 獲取日期中的中文月份 getWeek(date) // 獲取日期中的第幾周 getLocalWeek(date) // 獲取日期中的中文第幾周 getDayOfWeek(date) // 獲取日期中的星期幾 getLocalDayOfWeek(date) // 獲取日期中的中文星期幾 getDay(date) // 獲取日子 getLocalDay // 獲取中文日子 now() // 獲取現(xiàn)在時間 // 數(shù)值類 getLocalMoney(digit) // 將數(shù)值轉(zhuǎn)換為大寫金額 round(digit) // 數(shù)值四舍五入 ceil(digit) // 數(shù)值0舍1入 trunc(digit) // 向下取整 floor(digit) // 向下取整 abs(digit) // 求絕對值 sqrt(digit) // 開平方 log(digit) // 底數(shù)為e對數(shù) ln(digit) // 底數(shù)為e對數(shù) log10(digit) // 底數(shù)為10對數(shù) log2(digit) // 底數(shù)為2對數(shù) raiseToPower(x, n) // 計算 x 的 n 次方 exp(digit) // 求e的x次方 bitwiseXor(a, b) // a 異或 b onesComplement(a) // a 的補碼 average(digit, digit, ...) // 求平均 sum(digit, digit, ...) // 求和 count(digit, digit, ...) // 計數(shù) min(digit, digit, ...) // 找最小值 max(digit, digit, ...) // 找最大值 median(digit, digit, ...) // 找中值 mode(digit, digit, ...) // 一數(shù)組或數(shù)據(jù)區(qū)域中出現(xiàn)頻率最多的數(shù)值 stddev(digit, digit, ...) // 樣本標準偏差 random(void) // 獲取隨機數(shù)小數(shù) randomn(digit) // 獲取隨機數(shù)整數(shù) // 字符串類 contains("待檢字符串", "被包含字符串") // 檢查包含子字符串 unContains("待檢字符串", "不被包含字符串") // 檢查不包含子字符串 lowercase("字符串") // 轉(zhuǎn)小寫 uppercase("字符串") // 轉(zhuǎn)大寫 -
調(diào)用方式
// 三目運算函數(shù) [DFEvaluator eval:@"ternaryOperation(5<7, \"真\", \"假\")"]; // 獲取大寫金額 [DFEvaluator eval:@"getLocalMoney(10086)"]; // 復(fù)雜混合運算表達式 [DFEvaluator eval:@"dateDiff(\"dd\", \"2016-12-17\", now()) * 10 - getYear(now()) + max(11, 22,33,1000) * sqrt(floor(1000.445))"];
-
-
-
自定義函數(shù)的使用授艰，以 demo 為例：
第一步：自定義方法的OC實現(xiàn)
demo 中在 ViewController.m 實現(xiàn)了如下四個方法，可以看到返回時世落，均構(gòu)建了 DFEvaluatorFunctionResult 類實例來返回想诅，這是必須的；方法中傳入的 param 會根據(jù)表達式中調(diào)用函數(shù)時括號內(nèi)傳入的參數(shù)情況解析成字符串岛心，一維數(shù)組来破，或者二維數(shù)組，具體規(guī)則看如下代碼段的注釋忘古。
#pragma mark - 自定義函數(shù)測試 /* * 不帶參函數(shù) * 在表達式中寫入 test1() * * @return 創(chuàng)建 DFEvaluatorResult 實例徘禁，返回函數(shù)運行結(jié)果 */ - (DFEvaluatorFunctionResult *)test1 { return [[DFEvaluatorFunctionResult alloc] initWithResult:@"測試不帶參函數(shù)" dataType:DFEvaluatorFunctionResultDataTypeString] ; } /* * 帶一個加單參數(shù)的函數(shù) * * @param param 如在表達式中寫：test2(123) 則此處 param 為: @"123" * * @return 創(chuàng)建 DFEvaluatorFunctionResult 實例，返回函數(shù)運行結(jié)果 */ - (DFEvaluatorFunctionResult *)test2:(id)param { return [[DFEvaluatorFunctionResult alloc] initWithResult:[NSString stringWithFormat:@"測試帶參函數(shù)髓堪，傳入?yún)?shù)為：%@", param] dataType:DFEvaluatorFunctionResultDataTypeString]; } /* * 一維多參函數(shù)送朱，將所有參數(shù)拼接成一個字符串 * 如表達式中寫：test3(123, 456, 789...) 數(shù)量根據(jù)自己的需要來定 * * @param param 此處得到 param 為一維數(shù)組 @[@"123", @"456", @"789"...] * * @return 創(chuàng)建 DFEvaluatorFunctionResult 實例，返回函數(shù)運行結(jié)果 */ - (DFEvaluatorFunctionResult *)test3:(id)param { // 將所有參數(shù)拼接成一個字符串 NSMutableString *result = [NSMutableString string]; for(NSString *str in param) { [result appendString:str]; } return [[DFEvaluatorFunctionResult alloc] initWithResult:result dataType:DFEvaluatorFunctionResultDataTypeString]; } /* * 二維多參函數(shù)干旁，函數(shù)功能為將所有參數(shù)拼接為字符串 * 如表達式中寫：test3(123, [456, 789], @"333", [234]...) 數(shù)量根據(jù)自己的需要來定 * * @param param 此處得到 param 為二維數(shù)組 @[@"123", @[@"456", @"789"], @"333", @[@"234"]...] * * @return 創(chuàng)建 DFEvaluatorFunctionResult 實例驶沼，返回函數(shù)運行結(jié)果 */ - (DFEvaluatorFunctionResult *)test4:(id)param { NSMutableString *result = [NSMutableString string]; for(id obj in param) { if([obj isKindOfClass:[NSArray class]]) { for(NSString *str in (NSArray *)obj) { [result appendString:str]; } } else { [result appendString:obj]; } } return [[DFEvaluatorFunctionResult alloc] initWithResult:result dataType:DFEvaluatorFunctionResultDataTypeString]; }第二步：構(gòu)建 DFEvaluatorFunction 實例
如下代碼將上述四個 test 方法分別構(gòu)建一個 DFEvaluatorFunction 實例來進行描述，并以用于表達式調(diào)用的函數(shù)名為 key 存入字典争群，準備注入表達式解析計算器中回怜。- (NSDictionary *)customFunctions { if(!_customFunctions) { _customFunctions = [NSMutableDictionary dictionary]; // test1 無參函數(shù) DFEvaluatorFunction *function = [[DFEvaluatorFunction alloc] initWithFunctionName:@"test1" selector:@selector(test1) target:self]; [_customFunctions setObject:function forKey:function.functionName]; // test2 帶一個參數(shù)的函數(shù) function = [[DFEvaluatorFunction alloc] initWithFunctionName:@"test2" selector:@selector(test2:) target:self]; [_customFunctions setObject:function forKey:function.functionName]; // test3 帶多個一維參數(shù)的函數(shù) function = [[DFEvaluatorFunction alloc] initWithFunctionName:@"test3" selector:@selector(test3:) target:self]; [_customFunctions setObject:function forKey:function.functionName]; // test4 帶多個二維參數(shù)的函數(shù) function = [[DFEvaluatorFunction alloc] initWithFunctionName:@"test4" selector:@selector(test4:) target:self]; [_customFunctions setObject:function forKey:function.functionName]; } return _customFunctions; }第三步：將構(gòu)建好的 DFEvaluatorFunction 實例注入表達式解析計算器
代碼如下，即在 demo 中點擊 “計算” 按鈕時執(zhí)行的代碼/* * 創(chuàng)建表達式計算器對象 */ - (DFEvaluator *)evaluator { if(!_evaluator) { _evaluator = [[DFEvaluator alloc] init]; [_evaluator setCustomFunctions:self.customFunctions]; // 注入自定義函數(shù)集 // 默認就是這個格式 // [_evaluator setDateFormat:@"yyyy-MM-dd HH:mm:ss"]; // 默認就是 false换薄，即表達式支持函數(shù)調(diào)用玉雾，當表達式不需要函數(shù)調(diào)用是，調(diào)用該方法置為 true轻要，可以調(diào)高運算效率 // [_evaluator withoutFunctionTransfer:false]; } return _evaluator; }
最后上圖看看運行效果
1. 開始運行.png
2. 選擇函數(shù).png
3. 選擇指定測試用例.png
4. 選擇確定輸入到了輸入框.png
5. 表達式無誤完成計算.png
6. 表達式有錯誤計算失敗.png
感興趣請下載demo研究复旬，運行后，點擊快速測試冲泥，快速一睹 DFEvaluator 的風采吧驹碍！
意見建議請聯(lián)系：
QQ: 247159603
**博客：猿視界
