本文為投稿文章，作者:Flying_Einstein (簡書)

NSScanner官方文檔

NSScanner類是一個類簇的抽象父類,該類簇為一個從NSString對象掃描值的對象提供了程序接口。

NSScanner對象把NSString 對象的的字符解釋和轉化成 number和string 類型的值。在創建NSScanner對象的時候為它分配字符(string )，當你從NSScanner對象獲取內容的時候，它會從頭到尾遍歷字符串(string)。

由於類簇的屬性， scanner對象並不是 NSScanner類的實例，而是它一個私有子類的實例。盡管scanner對象的類是私有的，但是它的接口是公開的（抽象父類已經聲明）。 NSScanner 的原始方法是string和Configuring a Scanner方法下面列舉的所有的方法。

在 NSScanner 對象掃描字符串的時候，你可以通過設置屬性charactersToBeSkipped忽略某些字符。在掃描字符串之前，那些位於忽略字符集中的字符將會被跳過。默認的忽略字符是空格和回車字符。

可以通過[[scanner string] substringFromIndex:[scanner scanLocation]]獲取未掃描的字符串。

創建 Scanner對象

+ (instancetype)scannerWithString:(NSString *)aString
+ (id)localizedScannerWithString:(NSString *)aString
- (instancetype)initWithString:(NSString *)aString

• scannerWithString，返回值是 掃描過aString字符串的NSScanner 對象，該方法通過調用initWithString設置掃描字符串;

• localizedScannerWithString,返回值是 通過用戶默認的 locale方式掃描字符串的NSScanner 對象，該方法也是通過調用initWithString設置掃描字符串;

• initWithString，返回值是NSScanner 對象，該對象通過掃描aString完成初始化

獲取Scanner的字符串

@property(readonly, copy) NSString *string

配置Scanner

@property NSUInteger scanLocation
@property BOOL caseSensitive
@property(copy) NSCharacterSet *charactersToBeSkipped
@property(retain) id locale

• scanLocation,下次掃描開始的位置，如果該值超出了string的區域，將會引起NSRangeException,該屬性在發生錯誤後重新掃描時非常有用。

• caseSensitive，是否區分字符串中大小寫的標志。默認為NO，注意：該設置不會應用到被跳過的字符集。

• charactersToBeSkipped,在掃描時被跳過的字符集，默認是空白格和回車鍵。被跳過的字符集優先於掃描的字符集：例如一個scanner被跳過的字符集為空格，通過scanInt:去查找字符串中的整型數時，首先做的不是掃描，而是跳過空格，直到找到十進制數據或者其他的字符。在字符被掃描的時候，跳過功能就失效了。如果你掃描的字符和跳過的字符是一樣的，結果將是未知的。被跳過的字符是一個唯一值，scanner不會將忽略大小寫的功能應用於它，也不會用這些字符做一些組合，如果在掃描字符換的時候你想忽略全部的元音字符，就要這麼做（比如：將字符集設置成“AEIOUaeiou”};

• locale,scanner 的locale對它從字符串中區分數值產生影響，它通過locale的十進制分隔符區分浮點型數據的整數和小數部分。一個沒有locale的scanner用非定域值。新的scanner若沒有設置locale，使用默認locale。

掃描字符串

- (BOOL)scanCharactersFromSet:(NSCharacterSet *)scanSet   intoString:(NSString * _Nullable *)stringValue;
- (BOOL)scanUpToCharactersFromSet:(NSCharacterSet *)stopSet    intoString:(NSString * _Nullable *)stringValue;
- (BOOL)scanString:(NSString *)string  intoString:(NSString * _Nullable *)stringValue;
- (BOOL)scanUpToString:(NSString *)stopString   intoString:(NSString * _Nullable *)stringValue;
- (BOOL)scanDecimal:(NSDecimal *)decimalValue;
- (BOOL)scanDouble:(double *)doubleValue;
- (BOOL)scanFloat:(float *)floatValue;
- (BOOL)scanHexDouble:(double *)result;
- (BOOL)scanHexFloat:(float *)result;
- (BOOL)scanHexInt:(unsigned int *)intValue;
- (BOOL)scanHexLongLong:(unsigned long long *)result;
- (BOOL)scanInt:(int *)intValue;
- (BOOL)scanInteger:(NSInteger *)value;
- (BOOL)scanUnsignedLongLong:(unsigned long long *)unsignedLongLongValue;
@property(getter=isAtEnd, readonly) BOOL atEnd;

• scanCharactersFromSet:intoString:掃描字符串中和NSCharacterSet字符集中匹配的字符，是按字符單個匹配的，例如，NSCharacterSet字符集為@"test123Dmo"，scanner字符串為 @" 123test12Demotest"，那麼字符串中所有的字符都在字符集中，所以指針指向的地址存儲的內容為"123test12Demotest"

• scanUpToCharactersFromSet:intoString：掃描字符串直到遇到NSCharacterSet字符集的字符時停止，指針指向的地址存儲的內容為遇到跳過字符集字符之前的內容

• scanString:intoString:從當前的掃描位置開始掃描，判斷掃描字符串是否從當前位置能掃描到和傳入字符串相同的一串字符，如果能掃描到就返回YES,指針指向的地址存儲的就是這段字符串的內容。例如scanner的string內容為123abc678,傳入的字符串內容為abc，如果當前的掃描位置為0，那麼掃描不到，但是如果將掃描位置設置成3，就可以掃描到了。

• scanUpToString:intoString:從當前的掃描位置開始掃描，掃描到和傳入的字符串相同字符串時，停止，指針指向的地址存儲的是遇到傳入字符串之前的內容。例如scanner的string內容為123abc678,傳入的字符串內容為abc，存儲的內容為123

• scanDecimal:掃描NSDecimal類型的值，有關NSDecimal類型的值更多的信息可以查看：NSDecimalNumber

• scanDouble :掃描雙精度浮點型字符，溢出和非溢出都被認為合法的浮點型數據。在溢出的情況下scanner將會跳過所有的數字，所以新的掃描位置將會在整個浮點型數據的後面。double指針指向的地址存儲的數據為掃描出的值，包括溢出時的HUGE_VAL或者 –HUGE_VAL，即未溢出時的0.0。

• scanFloat：掃描單精度浮點型字符，具體內容同scanDouble

• scanHexDouble: 掃描雙精度的十六進制類型，溢出和非溢出都被認為合法的浮點型數據。在溢出的情況下scanner將會跳過所有的數字，所以新的掃描位置將會在整個浮點型數據的後面。double指針指向的地址存儲的數據為掃描出的值，包括溢出時的HUGE_VAL或者 –HUGE_VAL，即未溢出時的0.0。數據接收時對應的格式為 %a 或%A ，雙精度十六進制字符前面一定要加  0x或者 0X。

• scanHexInt 掃描十六進制無符整型，unsigned int指針指向的地址值為 掃描到的值，包含溢出時的UINT_MAX。

• scanHexLongLong 同scanHexDouble

• scanInt 掃描整型，溢出也被認為是有效的整型，int 指針指向的地址的值為掃描到的值，包含溢出時的INT_MAX或INT_MIN。

• scanInteger 同scanInt

• scanLongLong 掃描LongLong 型，溢出也被認為是有效的整型，LongLong指針指向的地址的值為掃描到的值，包含溢出時的LLONG_MAX 或 LLONG_MIN。

實例:

#import
@interface ConditionJudgmentController : NSObject
//輸入框中只能輸入數字和小數點，且小數點只能輸入一位，參數number 可以設置小數的位數，該函數在-(BOOL)textField:(UITextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string調用；
+(BOOL)isValidAboutInputText:(UITextField *)textfield shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string  decimalNumber: (NSInteger) number;
@end

#import "ConditionJudgmentController.h"
@implementation ConditionJudgmentController
+(BOOL)isValidAboutInputText:(UITextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string decimalNumber:(NSInteger)number{
NSScanner      *scanner    = [NSScanner scannerWithString:string];
NSCharacterSet *numbers;
NSRange         pointRange = [textField.text rangeOfString:@"."];
if ( (pointRange.length > 0) && (pointRange.location < range.location  || pointRange.location > range.location + range.length) ){
numbers = [NSCharacterSet characterSetWithCharactersInString:@"0123456789"];
}else{
numbers = [NSCharacterSet characterSetWithCharactersInString:@"0123456789."];
}
if ( [textField.text isEqualToString:@""] && [string isEqualToString:@"."] ){
return NO;
}
short remain = number; //保留 number位小數
NSString *tempStr = [textField.text stringByAppendingString:string];
NSUInteger strlen = [tempStr length];
if(pointRange.length > 0 && pointRange.location > 0){ //判斷輸入框內是否含有“.”。
if([string isEqualToString:@"."]){ //當輸入框內已經含有“.”時，如果再輸入“.”則被視為無效。
return NO;
}
if(strlen > 0 && (strlen - pointRange.location) > remain+1){ //當輸入框內已經含有“.”，當字符串長度減去小數點前面的字符串長度大於需要要保留的小數點位數，則視當次輸入無效。
return NO;
}
}
NSRange zeroRange = [textField.text rangeOfString:@"0"];
if(zeroRange.length == 1 && zeroRange.location == 0){ //判斷輸入框第一個字符是否為“0”
if(![string isEqualToString:@"0"] && ![string isEqualToString:@"."] && [textField.text length] == 1){ //當輸入框只有一個字符並且字符為“0”時，再輸入不為“0”或者“.”的字符時，則將此輸入替換輸入框的這唯一字符。
textField.text = string;
return NO;
}else{
if(pointRange.length == 0 && pointRange.location > 0){ //當輸入框第一個字符為“0”時，並且沒有“.”字符時，如果當此輸入的字符為“0”，則視當此輸入無效。
if([string isEqualToString:@"0"]){
return NO;
}
}
}
}
NSString *buffer;
if ( ![scanner scanCharactersFromSet:numbers intoString:&buffer] && ([string length] != 0) ){
return NO;
}else{
return YES;
}
}
@end

注意:上面的方法要結合UITextField的代理方法使用

-(BOOL)textField:(UITextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string
{
return [ConditionJudgmentController isValidAboutInputText:textField shouldChangeCharactersInRange:range replacementString:string decimalNumber:3];
}

結束語：

平時讀者在進行條件判斷時，可能使用正則表達式或者用if語句比較多一點，其實NSScanner類為我們提供了一個非常好的方式進行判斷。把它們結合起來使用，可以獲得更好的效果。