您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

NSScanner 詳解:iOS 字符串解析與條件判斷的利器

編輯:iOS 開發綜合

需要從一段混合了文字、數字、分隔符的字符串里依次取出目標內容時,很多人第一反應是用正則或者 componentsSeparatedByString:。但如果不是簡單的分割場景,而是「向後掃到某個字符為止」「連續讀取多個整數」「跳過指定字符再取值」這類需求,NSScanner 會比正則更直觀、也更好維護。

一、NSScanner 是什麼

NSScanner 是一個用於在字符串中逐字符掃描的工具類,特別擅長把文本翻譯(轉換)成數字或其他字符串。創建時指定要掃描的字符串,之後它會維護一個「當前掃描位置」,按你的要求從頭向後推進。

二、官方文檔要點

NSScanner 是一個類簇的抽象父類,為「從 NSString 對象中讀取值」這件事提供了統一編程接口。它把字符串中的字符解釋並轉化為 number 與 string 兩種類型的值。

由於類簇的特性,你拿到的 scanner 對象其實是 NSScanner 某個私有子類的實例。它的類是私有的,但接口完全公開——也就是抽象父类中聲明的那一整套方法。

掃描過程中,可以通過 charactersToBeSkipped 指定要忽略的字符。每次真正掃描前,落在忽略集合中的字符會被自動跳過。默認忽略的是空格與換行符。

如果想拿到尚未掃描的剩餘部分,可以用:

[[scanner string] substringFromIndex:[scanner scanLocation]]

三、創建 Scanner

+ (instancetype)scannerWithString:(NSString *)aString
+ (id)localizedScannerWithString:(NSString *)aString
- (instancetype)initWithString:(NSString *)aString
  • scannerWithString: 返回掃描指定字符串的 scanner,內部通過 initWithString: 完成初始化。
  • localizedScannerWithString: 返回按用戶默認 locale 掃描的 scanner,這對小數點、千分位格式有意義。
  • initWithString: 直接以 aString 初始化對象。

四、核心屬性

@property (readonly, copy) NSString *string;
@property NSUInteger scanLocation;
@property BOOL caseSensitive;
@property (copy) NSCharacterSet *charactersToBeSkipped;
@property (retain) id locale;

string:被掃描的原始字符串,只讀。

scanLocation:下次掃描的起始位置。如果設置成超出字符串範圍的值,會拋出 NSRangeException。出錯後想重新掃描時,這個屬性非常有用。

caseSensitive:是否區分大小寫,默認 NO。注意這個設置不會作用於被跳過的字符集。

charactersToBeSkipped:掃描時跳過的字符集,默認是空格和換行。它的優先級高於掃描目標:例如跳過集合為空格、調用 scanInt: 查找整數時,scanner 會先跳過空格,直到遇到十進制數字或其他字符為止;一旦開始掃描,跳過機制就失效。如果掃描目標與跳過字符相同,結果未定義。這個集合是「唯一值」語義,不會應用忽略大小寫設置,也不做字符組合。若想在掃描時忽略所有元音,需要顯式寫成 @"AEIOUaeiou"。

locale:影響數值解析,主要通過十進制分隔符決定浮點數的整數與小數部分如何切分。未設置 locale 的 scanner 使用非定域行為;新建的 scanner 默認使用系統 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: 逐個匹配字符集中的字符。例如字符集為 @"test123Dmo",掃描字符串為 @"123test12Demotest",由於字符串中每個字符都在集合內,結果會是整段 123test12Demotest。

scanUpToCharactersFromSet:intoString: 向後掃描,遇到集合中的字符即停止,返回值是停止之前的內容。

scanString:intoString: 從當前位置嘗試匹配傳入字符串。匹配成功返回 YES 並把匹配到的內容寫入指針。例如 scanner 的字符串為 123abc678,傳入 abc:掃描位置為 0 時匹配失敗,把 scanLocation 設為 3 後即可成功。

scanUpToString:intoString: 向後掃描直到遇到傳入字符串,返回它之前的內容。上例中返回 123。

scanDecimal: 掃描 NSDecimal 類型數值。

scanDouble: / scanFloat: 掃描雙精度/單精度浮點數。溢出也被視為合法浮點數,此時 scanner 會跳過整個數字,新位置落在數據之後;指針得到 HUGE_VAL 或 -HUGE_VAL,未溢出時得到對應數值。

scanHexDouble: / scanHexFloat: 掃描十六進制浮點數,格式為 %a 或 %A,字符串必須以 0x 或 0X 開頭。

scanHexInt: 掃描十六進制無符號整數,溢出時返回 UINT_MAX。scanHexLongLong: 行為類似 scanHexDouble。

scanInt: / scanInteger: / scanLongLong: 掃描整數,溢出同樣被視為有效,指針得到 INT_MAX、INT_MIN 或 LLONG_MAX、LLONG_MIN。

六、行為要點:掃描位置是連續的

這是使用 NSScanner 時最容易忽略的一點:一次掃描結束後,scanner 的位置並不會回到字符串開頭。下一次掃描會接著上次停止的位置繼續。想重新從頭開始,必須手動把 scanLocation 置為 0。

NSString *bananas = @"123.321abc137d efg/hij kl";
NSString *separatorString = @"fg";
BOOL result;
NSScanner *aScanner = [NSScanner scannerWithString:bananas];

// 掃描到指定字符串時停止
NSLog(@"掃描儀所在的位置:%lu", aScanner.scanLocation);
NSString *container;
result = [aScanner scanUpToString:separatorString intoString:&container];
NSLog(@"掃描成功:%@", result ? @"YES" : @"NO");
NSLog(@"掃描的返回結果:%@", container);
NSLog(@"掃描儀所在的位置:%lu", aScanner.scanLocation);

// 接著上次位置掃描整數
NSLog(@"---------- 1");
NSInteger anInteger;
result = [aScanner scanInteger:&anInteger];
NSLog(@"掃描成功:%@,結果:%ld,位置:%lu",
      result ? @"YES" : @"NO", anInteger, aScanner.scanLocation);

// 回到首位掃描整數
NSLog(@"---------- 2");
aScanner.scanLocation = 0;
NSInteger anInteger2;
result = [aScanner scanInteger:&anInteger2];
NSLog(@"掃描成功:%@,結果:%ld,位置:%lu",
      result ? @"YES" : @"NO", anInteger2, aScanner.scanLocation);

// 掃描浮點數
NSLog(@"---------- 3");
aScanner.scanLocation = 0;
float aFloat;
result = [aScanner scanFloat:&aFloat];
NSLog(@"掃描成功:%@,結果:%f,位置:%lu",
      result ? @"YES" : @"NO", aFloat, aScanner.scanLocation);

// 是否到達末尾
NSLog(@"---------- 4");
NSLog(@"字符串:%@,位置:%lu,是否末尾:%@",
      aScanner.string, aScanner.scanLocation, aScanner.isAtEnd ? @"YES" : @"NO");

// 掃描到指定字符集為止
NSLog(@"---------- 5");
aScanner.scanLocation = 0;
NSString *str;
NSCharacterSet *characterSet = [NSCharacterSet characterSetWithCharactersInString:@"/"];
result = [aScanner scanUpToCharactersFromSet:characterSet intoString:&str];
NSLog(@"掃描成功:%@,結果:%@,位置:%lu",
      result ? @"YES" : @"NO", str, aScanner.scanLocation);

七、實例一:循環提取字符串中的所有數字

NSString *numStr = @"a 1 b 2 c 3 d 4 e 5 f 6 o";
NSScanner *scanner = [NSScanner scannerWithString:numStr];
NSCharacterSet *numSet = [NSCharacterSet decimalDigitCharacterSet];

while (![scanner isAtEnd]) {
    if ([scanner scanUpToCharactersFromSet:numSet intoString:NULL]) {
        int num;
        if ([scanner scanInt:&num]) {
            NSLog(@"num = %d, location = %lu", num, scanner.scanLocation);
        }
    }
}

八、實例二:反過來——跳過數字

把 charactersToBeSkipped 設置為數字集合,效果就完全反轉了:scanner 會主動略過所有數字,只把非數字內容留給你。

NSString *numStr = @"a 1 b 2 c 3 d 4 e 5 f 6 o";
NSScanner *scanner = [NSScanner scannerWithString:numStr];

// 默認跳過空格和換行,這裡改成跳過數字
scanner.charactersToBeSkipped = [NSCharacterSet decimalDigitCharacterSet];

while (![scanner isAtEnd]) {
    if ([scanner scanUpToCharactersFromSet:[NSCharacterSet decimalDigitCharacterSet] intoString:NULL]) {
        int num;
        if ([scanner scanInt:&num]) {
            NSLog(@"num = %d, location = %lu", num, scanner.scanLocation);
        } else {
            NSLog(@"無結果");
        }
    }
}

九、實例三:解析結構化的商品清單

假設有這樣一段文本:

Product: Acme Potato Peeler; Cost: 0.98 73
Product: Chef Pierre Pasta Fork; Cost: 0.75 19
Product: Chef Pierre Colander; Cost: 1.27 2

下面這段代碼依次讀出商品名、單價和銷量,中間跳過 Product:、Cost: 與分號。由於 scanner 默認忽略空白與換行,循環里不需要額外處理這些字符:

NSString *string = @"Product: Acme Potato Peeler; Cost: 0.98 73\n\
Product: Chef Pierre Pasta Fork; Cost: 0.75 19\n\
Product: Chef Pierre Colander; Cost: 1.27 2\n";

NSCharacterSet *semicolonSet = [NSCharacterSet characterSetWithCharactersInString:@";"];
NSScanner *theScanner = [NSScanner scannerWithString:string];

NSString *PRODUCT = @"Product:";
NSString *COST = @"Cost:";
NSString *productName;
float productCost;
NSInteger productSold;

while (![theScanner isAtEnd]) {
    if ([theScanner scanString:PRODUCT intoString:NULL]
        && [theScanner scanUpToCharactersFromSet:semicolonSet intoString:&productName]
        && [theScanner scanString:@";" intoString:NULL]
        && [theScanner scanString:COST intoString:NULL]
        && [theScanner scanFloat:&productCost]
        && [theScanner scanInteger:&productSold]) {
        NSLog(@"Sales of %@: $%1.2f", productName, productCost * productSold);
    }
}

這個例子的價值在於展示了 NSScanner 的典型用法:用短路求值把一串掃描步驟串成一條鏈,任何一步失敗整個條件即不成立,天然具備容錯能力。相比切一堆字符串再逐段判空,這種寫法既簡短又不易出錯。

小結

NSScanner 的定位是「有狀態的顺序讀取器」。掌握三個要點就能用得很順手:一是 scanLocation 會持续推进,需要重來時手動歸零;二是 charactersToBeSkipped 的優先級高於掃描目標,是過濾噪聲的利器;三是所有 scan 方法都返回 BOOL,配合 && 鏈式判斷可以優雅地完成結構化文本解析。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved