iOS 數(shù)字精準計算之NSDecimalNumber


NSDecimalNumber簡介

顧名思義這是一個十進制數(shù)字類笔横,繼承自NSNumber,蘋果針對浮點類型計算精度問題提供出來的計算類咐吼,基于十進制的科學計數(shù)法來計算吹缔,同時可以指定舍入模式,一般用于貨幣計算锯茄。

初始化方法
/**
 創(chuàng)建并返回一個十進制對象
 @param dcm 十進制的結構體
 */
- (instancetype)initWithDecimal:(NSDecimal)dcm;

/**
 @param mantissa 十進制尾數(shù) (如:123)
 @param exponent 指數(shù)      (如:3)
 @param flag 是否為負      (如:YES)
 return 十進制數(shù)字對象       (如:-123000)
 */
- (instancetype)initWithMantissa:(unsigned long long)mantissa
                        exponent:(short)exponent
                      isNegative:(BOOL)flag;

/**
 @param numberValue 數(shù)字字符串
 */
- (instancetype)initWithString:(nullable NSString *)numberValue;

/**
 @param numberValue 數(shù)字字符串,可以根據locale來解析 (如:@"123,456")
 @param locale 解析<numberValue>的字典(特別是NSLocaleDecimalSeparator:分割整數(shù)跟小數(shù))
                                                (如 @{NSLocaleDecimalSeparator:@","})
 @return 十進制數(shù)字對象                           (如:123.456)
 */
- (instancetype)initWithString:(nullable NSString *)numberValue
                        locale:(nullable id)locale;

NSDecimalNumberHandler

這是一個NSDecimalNumber的公共協(xié)議處理類厢塘,可以設置舍入模式以及計算錯誤的處理;配合NSDecimalNumber來使用,將這個類的實例當做NSDecimalNumber相應API的參數(shù)來控制數(shù)字處理的結果俗冻。

/**
 初始化方法

 @param roundingMode 舍入方式
 @param scale 小數(shù)點后舍入值的位數(shù)礁叔。
 @param exact 精度錯誤處理;YES:如果出現(xiàn)錯誤迄薄,將引發(fā)異常琅关,NO:忽略錯誤并將控制權放回給調用者。
 @param overflow 溢出錯誤處理讥蔽;YES:如果出現(xiàn)錯誤涣易,將引發(fā)異常,NO:忽略錯誤并將控制權放回給調用者冶伞。
 @param underflow 下溢錯誤處理新症;YES:如果出現(xiàn)錯誤,將引發(fā)異常响禽,NO:忽略錯誤并將控制權放回給調用者徒爹。
 @param divideByZero 除以0的錯誤處理;YES:如果出現(xiàn)錯誤芋类,將引發(fā)異常隆嗅,NO:忽略錯誤并將控制權放回給調用者。
 @return NSDecimalNumberHandler對象
 */
+ (instancetype)decimalNumberHandlerWithRoundingMode:(NSRoundingMode)roundingMode
                                               scale:(short)scale
                                    raiseOnExactness:(BOOL)exact
                                     raiseOnOverflow:(BOOL)overflow
                                    raiseOnUnderflow:(BOOL)underflow
                                 raiseOnDivideByZero:(BOOL)divideByZero

/**
 快速構造方法

 roundingMode:NSRoundPlain
 scale:全精度
 exact:NO
 overflow:NO
 underflow:NO
 divideByZero:NO
 */
+ (NSDecimalNumberHandler *)defaultDecimalNumberHandler;

NSRoundingMode的幾種方式:

  • NSRoundPlain:四舍五入
  • NSRoundDown:只舍不入
  • NSRoundUp:只入不舍
  • NSRoundBankers: 在四舍五入的基礎上加了一個判斷:當最后一位為5的時候侯繁,只會舍入成偶數(shù)胖喳。比如:1.25不會返回1.3而是1.2,因為1.3不是偶數(shù)贮竟。
官方文檔提供的圖片

加法運算
/**
 @param decimalNumber 相加的十進制對象
 */
- (NSDecimalNumber *)decimalNumberByAdding:(NSDecimalNumber *)decimalNumber;

/**
 @param decimalNumber 相加的十進制對象
 @param behavior NSDecimalNumberHandler對象
 */
- (NSDecimalNumber *)decimalNumberByAdding:(NSDecimalNumber *)decimalNumber
                              withBehavior:(nullable id <NSDecimalNumberBehaviors>)behavior
減法運算
/**
 @param decimalNumber 減去的十進制對象
 */
- (NSDecimalNumber *)decimalNumberBySubtracting:(NSDecimalNumber *)decimalNumber;

/**
 @param decimalNumber 減去的十進制對象
 @param behavior NSDecimalNumberHandler對象
 */
- (NSDecimalNumber *)decimalNumberBySubtracting:(NSDecimalNumber *)decimalNumber
                                   withBehavior:(nullable id <NSDecimalNumberBehaviors>)behavior;
乘法運算
/**
 @param decimalNumber 相乘的十進制對象
 */
- (NSDecimalNumber *)decimalNumberByMultiplyingBy:(NSDecimalNumber *)decimalNumber;

/**
 @param decimalNumber 相乘的十進制對象
 @param behavior NSDecimalNumberHandler對象
 */
- (NSDecimalNumber *)decimalNumberByMultiplyingBy:(NSDecimalNumber *)decimalNumber
                                     withBehavior:(nullable id <NSDecimalNumberBehaviors>)behavior;
除法運算
/**
 @param decimalNumber 除以的十進制對象
 */
- (NSDecimalNumber *)decimalNumberByDividingBy:(NSDecimalNumber *)decimalNumber;

/**
 @param decimalNumber  除以的十進制對象
 @param behavior NSDecimalNumberHandler對象
 */
- (NSDecimalNumber *)decimalNumberByDividingBy:(NSDecimalNumber *)decimalNumber
                                  withBehavior:(nullable id <NSDecimalNumberBehaviors>)behavior;
次方運算
/**
 @param power 指數(shù)
 return 調用者的power次方
 */
- (NSDecimalNumber *)decimalNumberByRaisingToPower:(NSUInteger)power;

/**
 @param power 指數(shù)
 @param behavior NSDecimalNumberHandler對象
 return 調用者的power次方
 */
- (NSDecimalNumber *)decimalNumberByRaisingToPower:(NSUInteger)power
                                      withBehavior:(nullable id <NSDecimalNumberBehaviors>)behavior;
10為底的乘方運算
/**
 調用者乘以10的power次方

 @param power 10的指數(shù)
 */
- (NSDecimalNumber *)decimalNumberByMultiplyingByPowerOf10:(short)power;

/**
 調用者乘以10的power次方

 @param power 10的指數(shù)
 @param behavior NSDecimalNumberHandler對象
 */
- (NSDecimalNumber *)decimalNumberByMultiplyingByPowerOf10:(short)power
                                              withBehavior:(nullable id <NSDecimalNumberBehaviors>)behavior;
舍入運算
/**
 @param decimalNumber NSDecimalNumberHandler對象
 */
- (NSDecimalNumber *)decimalNumberByRoundingAccordingToBehavior:(nullable id <NSDecimalNumberBehaviors>)behavior;

總結

之前被這個NSRoundingMode狠狠的坑了一把丽焊,把NSRoundBankers當做四舍五入,最后運算出來的結果有時跟后臺差0.1咕别,查了好久技健,最后在蘋果官方文檔上才發(fā)現(xiàn)模式用錯了??。所以在這里我主要把一系列的API跟參數(shù)進行解釋顷级,方便大家去理解運用凫乖。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市弓颈,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌删掀,老刑警劉巖翔冀,帶你破解...
    沈念sama閱讀 218,755評論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異披泪,居然都是意外死亡纤子,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,305評論 3 395
  • 文/潘曉璐 我一進店門选酗,熙熙樓的掌柜王于貴愁眉苦臉地迎上來哪痰,“玉大人,你說我怎么就攤上這事该面】ㄇ” “怎么了翼悴?”我有些...
    開封第一講書人閱讀 165,138評論 0 355
  • 文/不壞的土叔 我叫張陵,是天一觀的道長幔妨。 經常有香客問我鹦赎,道長,這世上最難降的妖魔是什么误堡? 我笑而不...
    開封第一講書人閱讀 58,791評論 1 295
  • 正文 為了忘掉前任古话,我火速辦了婚禮,結果婚禮上锁施,老公的妹妹穿的比我還像新娘陪踩。我一直安慰自己,他們只是感情好悉抵,可當我...
    茶點故事閱讀 67,794評論 6 392
  • 文/花漫 我一把揭開白布肩狂。 她就那樣靜靜地躺著,像睡著了一般基跑。 火紅的嫁衣襯著肌膚如雪婚温。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,631評論 1 305
  • 那天媳否,我揣著相機與錄音栅螟,去河邊找鬼。 笑死篱竭,一個胖子當著我的面吹牛力图,可吹牛的內容都是我干的。 我是一名探鬼主播掺逼,決...
    沈念sama閱讀 40,362評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼吃媒,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了吕喘?” 一聲冷哼從身側響起赘那,我...
    開封第一講書人閱讀 39,264評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎氯质,沒想到半個月后募舟,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經...
    沈念sama閱讀 45,724評論 1 315
  • 正文 獨居荒郊野嶺守林人離奇死亡闻察,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,900評論 3 336
  • 正文 我和宋清朗相戀三年拱礁,在試婚紗的時候發(fā)現(xiàn)自己被綠了琢锋。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,040評論 1 350
  • 序言:一個原本活蹦亂跳的男人離奇死亡呢灶,死狀恐怖吴超,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情鸯乃,我是刑警寧澤鲸阻,帶...
    沈念sama閱讀 35,742評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站飒责,受9級特大地震影響赘娄,放射性物質發(fā)生泄漏。R本人自食惡果不足惜宏蛉,卻給世界環(huán)境...
    茶點故事閱讀 41,364評論 3 330
  • 文/蒙蒙 一遣臼、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧拾并,春花似錦揍堰、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,944評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至之碗,卻和暖如春蝙眶,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背褪那。 一陣腳步聲響...
    開封第一講書人閱讀 33,060評論 1 270
  • 我被黑心中介騙來泰國打工幽纷, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人博敬。 一個月前我還...
    沈念sama閱讀 48,247評論 3 371
  • 正文 我出身青樓友浸,卻偏偏與公主長得像,于是被迫代替她去往敵國和親偏窝。 傳聞我的和親對象是個殘疾皇子收恢,可洞房花燭夜當晚...
    茶點故事閱讀 44,979評論 2 355

推薦閱讀更多精彩內容